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 文件獲取詳細信息。