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。