MCP Server Template For Better Ai Coding

🚀 MCP 服務器模板，用於更高效的 AI 編碼

本模板為在 Python 中構建 Model Context Protocol (MCP) 服務器提供了流線化的基礎實現，能讓 AI 輔助的 MCP 工具開發變得更高效、直觀。

🚀 快速開始

此模板受啟發於 MCP 官方教程，若要使用該模板，需滿足以下先決條件：

• Python 3.12+ 及以上版本
• 依賴項：
  • mcp>=1.4.1
  • httpx>=0.28.1
  • starlette>=0.46.1
  • uvicorn>=0.15.0

安裝依賴

使用以下命令安裝所需的 Python 包：

pip install mcp httpx starlette uvicorn

克隆倉庫

將此模板克隆到本地機器：

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

啟動服務器

在終端中運行以下命令啟動 MCP 服務器：

uvicorn main:app --reload

這將在默認端口 8000 上啟動一個開發服務器，支持自動重載功能。

調用 API

使用以下 curl 命令測試基本 API 功能：

curl http://localhost:8000/api/hello

✨ 主要特性

• 現成可用的 MCP 服務器實現
• 可配置的傳輸模式（標準輸入輸出、SSE）
• 示例天氣服務集成（NWS API）
• 清晰、文檔齊全的代碼結構
• 最小化依賴項
• 嵌入式 MCP 規範和文檔，提升 AI 工具的理解能力

🔧 技術細節

Cursor Rules 整合

該項目使用 Cursor Rules 以提高 AI 編碼輔助的質量，結合了來自 Awesome Cursor Rules 的模式。

• 代碼整潔指南：內置的整潔代碼規則有助於保持一致性和質量
• 增強 AI 理解能力：規則為 AI 助手提供了上下文，使其能生成更優質代碼
• 標準化模式：遵循 MCP 服務器實現的最佳實踐

Cursor Rules 幫助 AI 編碼助手和人類開發者共同維護高標準的代碼質量，並遵循既定最佳實踐。

集成式 MCP 文檔

此模板包含全面的 MCP 文檔，直接嵌入在項目中：

• 完整的 MCP 規範 (protocals/mcp.md)：詳細說明了 AI 模型如何與外部工具和資源交互的協議。這使 AI 工具無需外部參考即可理解 MCP 概念。
• Python SDK 使用指南 (protocals/sdk.md)：關於 MCP Python SDK 的詳細文檔，使 AI 工具更容易提供準確的代碼建議，並全面瞭解該庫的功能。
• 示例實現 (protocals/example_weather.py)：一個實際的天氣服務實現，展示了現實世界中的 MCP 服務器模式和最佳實踐。

將這些資源嵌入項目中，使 AI 編碼助手能夠更好地理解 MCP 概念，並在開發期間提供更準確、上下文相關的建議。

📚 詳細文檔

項目結構

項目的典型目錄結構如下：

mcp-server-template/
├── main.py           # 主應用入口
├── config.py         # 配置管理
├── routes/           # 路由定義
│   └── api.py        # API 路由
├── middleware/       # 中間件
│   └── auth.py       # 認證中間件
└── templates/        # 模板文件
    └── index.html     # 默認模板

學習資源

• MCP 官方文檔
• 協議文檔
• SDK 使用指南

📄 許可證

本項目使用 MIT License 授權，詳情請參閱 LICENSE 文件。

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。