MCP 服务器

一个基于 FastAPI 实现的，基于模型-控制器-提供者 (MCP) 架构的服务器。

项目结构

.
├── api/              # API 路由和端点
│   └── v1/          # API 版本 1
│       ├── __init__.py
│       └── items.py # Item 端点
├── controllers/      # 业务逻辑和请求处理
│   └── item_controller.py
├── providers/       # 数据访问和外部服务集成
│   └── item_provider.py
├── models/         # 数据模型和数据库模式
│   └── item.py
├── core/          # 核心配置和实用工具
│   ├── config.py  # 应用配置
│   └── database.py # 数据库配置
├── main.py        # 应用入口点
├── requirements.txt # 项目依赖
├── environment.yml  # Conda 环境文件
└── README.md      # 项目文档

特性

• 基于 FastAPI 的 REST API: 高性能，易于使用，快速编码
• MCP 架构:
  • 模型 (Models): 数据结构和数据库模式
  • 控制器 (Controllers): 业务逻辑和请求处理
  • 提供者 (Providers): 数据访问和外部服务集成
• 现代技术栈:
  • SQLAlchemy 用于 ORM
  • Pydantic 用于数据验证
  • FastAPI 用于 API 框架
  • SQLite 用于开发数据库
• API 特性:
  • 自动生成 OpenAPI 文档
  • 请求验证
  • 响应序列化
  • CORS 中间件
  • 类型检查

设置

1. 创建一个 Conda 环境:

# 创建一个使用 Python 3.12 的新环境
conda create -n codeMcpServer python=3.12
# 激活环境
conda activate codeMcpServer

2. 安装依赖:

# 使用提供的环境文件 (推荐)
conda env create -f environment.yml

# 或者使用 pip
pip install -r requirements.txt

# 或者使用 conda 并指定 conda-forge 频道
conda config --add channels conda-forge
conda install --file requirements.txt

3. 运行服务器:

uvicorn main:app --reload

服务器将在 http://localhost:8000 启动

依赖

本项目的主要依赖:

• Python 3.12.9
• FastAPI 0.112.2
• SQLAlchemy 2.0.37
• Pydantic 2.11.2
• Uvicorn 0.32.1
• Python-dotenv 0.21.0

有关完整列表，请参见 environment.yml 或 requirements.txt。

环境管理

导出环境

要导出您的环境以进行共享:

# 导出包含确切版本的完整环境 (不包含前缀)
conda env export | grep -v "^prefix: " > environment.yml

# 或者仅导出手动安装的包
conda env export --from-history > environment.yml

导入环境

要从导出的文件重新创建环境:

conda env create -f environment.yml

API 文档

服务器运行后，您可以访问:

• 交互式 API 文档 (Swagger UI): http://localhost:8000/docs
• 备选 API 文档 (ReDoc): http://localhost:8000/redoc

API 端点

Items API (/api/v1/items)

• GET /api/v1/items/: 列出所有 items
• GET /api/v1/items/{item_id}: 获取特定 item
• POST /api/v1/items/: 创建一个新的 item
• PUT /api/v1/items/{item_id}: 更新一个 item
• DELETE /api/v1/items/{item_id}: 删除一个 item

开发

项目组织

该项目遵循 MCP (模型-控制器-提供者) 模式:

• 模型 (Models): 定义数据结构和数据库模式
• 控制器 (Controllers): 处理业务逻辑和请求处理
• 提供者 (Providers): 管理数据访问和外部服务集成

添加新功能

1. 在 models/ 中创建模型
2. 在 providers/ 中创建提供者
3. 在 controllers/ 中创建控制器
4. 在 api/v1/ 中创建 API 端点

贡献

1. Fork 仓库
2. 创建一个特性分支
3. 提交您的更改
4. 推送到分支
5. 创建一个 Pull Request

许可证

本项目根据仓库中包含的 LICENSE 文件中的条款获得许可。