MCP服务器示例
此存储库包含模型上下文协议(MCP)服务器的两个示例实现,演示了如何在Python和TypeScript中构建简单的MCP服务器。
什么是MCP?
模型上下文协议(MCP)是一个开放协议,它规范了应用程序如何向大型语言模型(LLM)提供上下文。MCP服务器公开了可供Claude等MCP客户端发现和使用的工具、资源和提示。
此存储库中的示例
1.Python MCP服务器(python/)
使用Python MCP SDK和FastMCP的最小MCP服务器实现。
特征:
- 工具:
add(a, b)-将两个数字相加 - 运输: 流式HTTP
- 框架: FastMCP(基于Starlette构建)
- 健康检查: 获取
/health
快速入门:
cd python
uv run main.py使用Docker:
cd python
docker build -t python-mcp-server .
docker run -p 9000:9000 python-mcp-server依赖关系:
- Python 3.11+
- mcp>=1.0.0
- uv(包管理器)
2.TypeScript MCP服务器(typescript/)
使用TypeScript MCP SDK和Express.js的类型安全MCP服务器实现。
特征:
- 工具:
add-通过Zod模式验证添加两个数字 - 运输: 流式HTTP服务器传输
- 框架: Express.js
- 健康检查: 获取
/health - MCP端点: 发布
/mcp
快速入门:
cd typescript
npm install
npm run dev使用Docker:
cd typescript
docker build -t typescript-mcp-server .
docker run -p 9000:9000 typescript-mcp-server依赖关系:
- Node.js 20+
- @模型上下文协议/sdk
- Express.js
- Zod(用于模式验证)
项目结构
obot-mcp-examples/
├── python/
│ ├── main.py # Server implementation
│ ├── pyproject.toml # Project configuration
│ ├── Dockerfile # Container definition
│ └── CLAUDE.md # Development guidelines
├── typescript/
│ ├── src/
│ │ └── index.ts # Server implementation
│ ├── package.json # Project configuration
│ ├── tsconfig.json # TypeScript config
│ ├── Dockerfile # Container definition
│ ├── README.md # Detailed documentation
│ └── CLAUDE.md # Development guidelines
└── README.md # This file用例
这些例子表明:
- 如何创建基本的MCP服务器
- 如何通过MCP公开工具
- 如何使用StreamableHTTP传输
- 如何添加健康检查端点
- 如何将MCP服务器容器化
了解更多
许可证
有关许可证信息,请参阅各个项目目录。
