🚀 MCP 服务器

MCP 服务器基于 FastAPI 实现了 Model-Controller-Provider (MCP) 架构。它能高效处理业务逻辑，借助现代技术栈，为开发者提供便捷的 API 开发体验。

🚀 快速开始

环境搭建

1. 创建 Conda 环境：

# 创建一个名为 codeMcpServer 的新环境，使用 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 启动

开发环境启动

1. 克隆仓库：

git clone [仓库地址]
cd mcp-server

2. 创建并激活 Conda 环境：

conda create -n mcp_env python=3.8
conda activate mcp_env

3. 安装依赖：

pip install -r requirements.txt

4. 启动服务器：

python main.py

✨ 主要特性

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

📦 安装指南

依赖安装

项目中的关键依赖项：

• 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 list --export > requirements.txt

导入环境

要导入现有环境文件：

# 使用 Conda 环境文件
conda env create -f environment.yml

# 或者使用 pip 要求文件
pip install -r requirements.txt

📚 详细文档

请参阅项目中的 docs 目录，了解完整的 API 文档和实现细节。

API 文档

完整的 API 文档可以在以下链接查阅：

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

🔧 技术细节

项目结构

.
├── api/              # API 路由和端点
│   └── v1/          # API 版本 1
│       ├── __init__.py
│       └── items.py # 项目端点
├── 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      # 项目文档

开发时遵循的项目结构：

.
├── src/           # 核心代码
│   ├── MCP/
│   │   ├── controllers/     # 请求处理逻辑
│   │   ├── providers/       # 数据访问逻辑
│   │   └── models/          # 数据模型定义
│   ├── config.py            # 应用程序配置
│   └── database.py          # 数据库连接配置
├── main.py        # 应用程序入口点
├── requirements.txt # 项目依赖
└── README.md      # 项目文档

🤝 贡献

提交代码

在提交代码之前，请确保：

1. 运行所有测试用例并确保其通过：

pytest tests/

2. 确保代码符合项目编码规范。
3. 更新相关的文档和注释。
4. 创建清晰且具有描述性的提交信息。

问题报告

请在 GitHub 仓库中创建一个问题，描述详细的问题信息。

📄 许可证

该项目受 MIT License 许可保护。