MCP Calculator Server

MCP Calculator Server

site icon
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=1MCP_STDIO_MODE=1 来确保只运行一种模式。
  • 问题:如何在 Smithery 中集成该服务器? 解答:使用 stdio 模式并配置 Smithery 的本地工具集成。

使用教程

使用依赖

  1. 创建虚拟环境(推荐):
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. 安装依赖:
pip install -r requirements.txt

安装教程

  1. 运行 HTTP 模式(推荐用于生产和容器环境):
export MCP_HTTP_MODE=1  # On Windows: set MCP_HTTP_MODE=1
uvicorn server:app --host 0.0.0.0 --port 8000
  1. 运行 Smithery 模式(本地工具集成):
export MCP_STDIO_MODE=1  # On Windows: set MCP_STDIO_MODE=1
python server.py
  1. 运行双模式(仅用于开发):
python server.py

调试方式

  1. 检查健康状态:
curl -X GET http://localhost:8000/health
  1. 获取可用工具列表:
curl -X GET http://localhost:8000/tools
  1. 测试计算器功能:
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