Freedanfan MCP Server

🚀 MCP 服务器

本项目基于 FastAPI 和 MCP（模型上下文协议）构建，实现了 AI 模型与开发环境间标准化的上下文交互。它简化了模型部署，提供高效 API 端点，确保输入输出一致，显著提升了 AI 应用的扩展性和维护性，让开发者能更轻松地集成和管理 AI 任务。

🚀 快速开始

本项目基于 FastAPI 和 MCP 构建，实现了 AI 模型与开发环境间标准化的上下文交互。下面为你介绍如何快速启动并使用本项目。

安装步骤

1. 克隆仓库：

git clone https://github.com/yourusername/mcp-server.git
cd mcp-server

2. 安装依赖：

pip install -r requirements.txt

服务器启动

运行 mcp_server.py 脚本以启动 MCP 服务器：

python mcp_server.py

默认情况下，服务器将在端口 8000 上运行。你可以通过环境变量 MCP_SERVER_HOST 和 MCP_SERVER_PORT 自定义主机和端口。

客户端使用

在 mcp_client.py 中配置服务器地址和其他参数后，即可调用相关功能。例如：

from mcp_client import MCPClient

client = MCPClient(server_url="http://localhost:8000")
response = client.request("command", parameters)
print(response)

✨ 主要特性

• JSON-RPC 2.0：基于标准 JSON-RPC 2.0 协议的请求 - 响应通信。
• SSE 连接：支持服务器推送事件（Server-Sent Events）连接，实现实时通知。
• 模块化设计：采用模块化架构，便于扩展和定制。
• 异步处理：使用 FastAPI 和异步 IO 实现高性能服务。
• 完整的客户端：包含一个全面的测试客户端实现。

📦 安装指南

1. 克隆仓库：

git clone https://github.com/yourusername/mcp-server.git
cd mcp-server

2. 安装依赖：

pip install -r requirements.txt

💻 使用示例

基础用法

服务器启动

python mcp_server.py

默认情况下，服务器将在端口 8000 上运行。你可以通过环境变量 MCP_SERVER_HOST 和 MCP_SERVER_PORT 自定义主机和端口。

客户端使用

from mcp_client import MCPClient

client = MCPClient(server_url="http://localhost:8000")
response = client.request("command", parameters)
print(response)

📚 详细文档

详细文档请参阅项目仓库中的 docs 目录，包括 API 参考、使用指南和开发说明。

🔧 技术细节

项目结构

mcp_server/
├── mcp_server.py         # MCP 服务器主程序
├── mcp_client.py         # MCP 客户端测试程序
├── routers/
│   ├── __init__.py       # 路由器包初始化
│   └── base_router.py    # 基础路由器实现
├── requirements.txt      # 项目依赖
└── README.md             # 项目文档

📄 许可证

该项目在 MIT License 下开源。查看 LICENSE 文件获取详细信息。