WeKnoraMCP/
├── 📦 核心文件
│   ├── __init__.py              # 包初始化文件
│   ├── weknora_mcp_server.py   # MCP 服务器核心实现
│   └── requirements.txt        # 项目依赖
│
├── 🚀 启动脚本 (多种方式)
│   ├── main.py                 # 主入口点 (推荐) ⭐
│   ├── run_server.py          # 原始启动脚本
│   └── run.py                 # 便捷启动脚本
│
├── 📋 配置文件
│   ├── setup.py               # 传统安装脚本
│   ├── pyproject.toml         # 现代项目配置
│   └── MANIFEST.in            # 包含文件清单
│
├── 🧪 测试文件
│   ├── test_module.py         # 模组功能测试
│   └── test_imports.py        # 导入测试
│
├── 📚 文档文件
│   ├── README.md              # 项目说明
│   ├── INSTALL.md             # 详细安装指南
│   ├── EXAMPLES.md            # 使用示例
│   ├── CHANGELOG.md           # 更新日志
│   ├── PROJECT_SUMMARY.md     # 项目总结 (本文件)
│   └── LICENSE                # MIT 许可证
│
└── 📂 其他
    ├── __pycache__/           # Python 缓存 (自动生成)
    ├── .codebuddy/           # CodeBuddy 配置
    └── .venv/                # 虚拟环境 (可选)

python main.py                    # 基本启动
python main.py --check-only       # 仅检查环境
python main.py --verbose          # 详细日志
python main.py --help            # 显示帮助

python run_server.py

python run.py

python weknora_mcp_server.py

python -m weknora_mcp_server

pip install -e .                  # 开发模式安装
weknora-mcp-server               # 主命令
weknora-server                   # 别名命令

pip install .                    # 生产安装
weknora-mcp-server              # 全局命令

# Linux/macOS
export WEKNORA_BASE_URL="http://localhost:8080/api/v1"
export WEKNORA_API_KEY="your_api_key_here"

# Windows PowerShell
$env:WEKNORA_BASE_URL="http://localhost:8080/api/v1"
$env:WEKNORA_API_KEY="your_api_key_here"

# Windows CMD
set WEKNORA_BASE_URL=http://localhost:8080/api/v1
set WEKNORA_API_KEY=your_api_key_here

# 1. 安装依赖
pip install -r requirements.txt

# 2. 设置环境变量
export WEKNORA_BASE_URL="http://localhost:8080/api/v1"
export WEKNORA_API_KEY="your_api_key"

# 3. 启动服务器
python main.py

pip install -e .
weknora-mcp-server

pip install .
weknora-mcp-server

# 传统方式
python setup.py sdist bdist_wheel

# 现代方式
pip install build
python -m build

python test_module.py

WeKnora MCP Server 模组测试
==================================================
✓ 模块导入测试通过
✓ 环境配置测试通过  
✓ 客户端创建测试通过
✓ 文件结构测试通过
✓ 入口点测试通过
✓ 包安装测试通过
==================================================
测试结果: 6/6 通过
✓ 所有测试通过！模组可以正常使用。

python main.py --verbose

pip install .
weknora-mcp-server

FROM python:3.11-slim
WORKDIR /app
COPY . .
RUN pip install .
CMD ["weknora-mcp-server"]

[Unit]
Description=WeKnora MCP Server

[Service]
ExecStart=/usr/local/bin/weknora-mcp-server
Environment=WEKNORA_BASE_URL=http://localhost:8080/api/v1

python main.py --verbose          # 详细日志
python test_module.py            # 运行测试