模型上下文协议服务器

MCP服务器指南和示例

构建模型上下文协议（MCP）服务器的全面指南和示例实现集合。这个存储库演示了如何用多种语言创建MCP服务器，重点是Python和TypeScript。

🚀 特性

• 完整的服务器示例：

  • 支持异步的Python最小服务器
  • 带有ES模块的TypeScript最小服务器
  • 这两种实现都展示了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)

🤝 贡献

欢迎投稿！请随时提交拉取请求。

📄 许可证

此项目根据ISC许可证获得许可-有关详细信息，请参阅许可证文件。