MCP Server Guide & Examples

MCP 服务指南与示例

一份全面的指南和示例实现集，介绍如何构建 Model Context Protocol（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）

🤝 贡献

欢迎贡献！欢迎提交 Pull Request。

📄 许可证

本项目采用 ISC License 许可，详情请参阅 LICENSE 文件。