
MCP Calculator Server

2025.03.07
0
Python计算服务MCP 协议其它
vault-python-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务器实现,提供基本的计算器功能。该服务器可以通过 REST API 提供算术运算服务,并支持多种通信模式(HTTP、WebSocket、stdio)。它适用于生产环境部署、容器化场景以及 Smithery 本地工具集成。
View on GitHub
Overview
基本能力
产品定位
vault-python-mcp-server 是一个基于 MCP 协议的服务器实现,主要用于提供基本的算术运算功能,并支持多种通信模式。
核心功能
- 基本算术运算(加、减、乘、除)
- 符合 MCP 协议的 API 端点
- JSON 模式验证
- 错误处理
- 多种通信模式(HTTP、WebSocket、stdio)
- 针对不同部署场景的专用入口点
适用场景
- 生产环境部署
- 容器化环境
- Smithery 本地工具集成
- 开发测试
工具列表
- 计算器工具:提供基本的算术运算功能,包括加、减、乘、除。
常见问题解答
- 问题:如何避免 HTTP 和 stdio 模式同时运行导致的冲突?
解答:通过设置环境变量
MCP_HTTP_MODE=1
或MCP_STDIO_MODE=1
来确保只运行一种模式。 - 问题:如何在 Smithery 中集成该服务器? 解答:使用 stdio 模式并配置 Smithery 的本地工具集成。
使用教程
使用依赖
- 创建虚拟环境(推荐):
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
- 安装依赖:
pip install -r requirements.txt
安装教程
- 运行 HTTP 模式(推荐用于生产和容器环境):
export MCP_HTTP_MODE=1 # On Windows: set MCP_HTTP_MODE=1
uvicorn server:app --host 0.0.0.0 --port 8000
- 运行 Smithery 模式(本地工具集成):
export MCP_STDIO_MODE=1 # On Windows: set MCP_STDIO_MODE=1
python server.py
- 运行双模式(仅用于开发):
python server.py
调试方式
- 检查健康状态:
curl -X GET http://localhost:8000/health
- 获取可用工具列表:
curl -X GET http://localhost:8000/tools
- 测试计算器功能:
curl -X POST http://localhost:8000/ \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "execute", "params": {"function_calls": [{"name": "calculator", "parameters": {"operation": "add", "numbers": [1, 2, 3, 4]}}]}, "id": 1}'
许可证
None