MCP 服务器指南与示例

一个全面的指南及实现示例集合，用于构建模型上下文协议（MCP）服务器。此仓库展示了如何使用多种语言创建MCP服务器，重点在于Python和TypeScript。

🚀 功能亮点

• 完整的服务器示例：

  • Python最小化服务器带有异步支持
  • TypeScript最小化服务器使用ES模块
  • 两个实现均展示核心的MCP概念

• 核心功能示例：

  • 工具（计算、获取JSON、文件I/O）
  • 资源（静态和动态）
  • 提示与模板
  • 日志记录及错误处理

• 安全与最佳实践：

  • 带沙盒的文件操作
  • 错误处理模式
  • 日志策略
  • 类型安全（TypeScript/Pydantic）

📚 文档

• 服务器指南 - 主要文档与教程
• Python示例 - Python实现细节
• TypeScript示例 - TypeScript实现细节

🛠️ 快速开始

1. 选择您偏好的实现方式：

   # Python
   cd examples/python-minimal
   pip install -r requirements.txt
   python server.py
   
   # TypeScript
   cd examples/typescript-minimal
   npm install
   npm run build
   npm start
   

2. 使用MCP CLI连接：

   mcp-cli connect
   

📋 先决条件

• Python 3.8+（针对Python示例）
• Node.js 16+（针对TypeScript示例）
• MCP CLI工具 (npm install -g @modelcontextprotocol/cli)

🤝 贡献指南

欢迎贡献！请随意提交Pull Request。

📄 许可证

本项目使用ISC许可证，详情请见LICENSE文件。