数学表达式计算服务

一个基于Model Context Protocol (MCP)的数学表达式计算服务,支持通过Python客户端或VSCode扩展进行安全计算。

  • by linuxacademyir
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 linuxacademyir/calculator-mcp

使用说明

MCP计算器服务器

该项目是一个简单的模型上下文协议(MCP)服务器,用于评估MCP客户端发送的数学表达式。它可以与官方的MCP Python客户端或VSCode MCP扩展一起使用。


特性

  • 使用Python计算数学表达式 math 模块(例如。, sqrt(25) + 2**3).
  • 安全评估:只有数学函数/常量可用。
  • 暴露a calculate 工具通过MCP协议。
  • 与兼容 模型上下文协议VSCode扩展.

设置

  1. 克隆存储库并输入目录:

    git clone <your-repo-url>
    cd calculator-mcp
    
  2. 创建并激活虚拟环境(推荐):

    python3 -m venv venv
    source venv/bin/activate
    
  3. 安装依赖项:

    pip install -r requirements.txt
    

运行MCP服务器

启动服务器(默认情况下,它监听端口8500、根路径上的所有接口):

python app.py

您应该看到:

MCP server running on 0.0.0.0:8500 (root path)

使用Python客户端

提供的 client.py 可用于测试服务器:

python client.py

这将发送表达式 sqrt(25) + 2**3 发送到服务器并打印结果。

您可以修改 client.py 发送其他表达。


在VSCode中使用MCP服务器

  1. 安装MCP扩展:

    • 打开VSCode。
    • 转到扩展(Ctrl+Shift+X 或 Cmd+Shift+X).
    • 搜索 Model Context Protocol 或 MCP 并安装官方扩展。
  2. 启动MCP服务器:

    • 确保 python app.py 正在运行。
  3. 将VSCode连接到MCP服务器:

    • 打开命令选项板(Ctrl+Shift+P 或 Cmd+Shift+P).
    • 类型 MCP: Add Server 或 MCP: Connect to Server.
    • 输入服务器URL:
      http://127.0.0.1:8500/
      
    • 给它起个名字(例如,“计算器MCP”)。
  4. 在VSCode中使用MCP工具:

    • 打开MCP侧栏(查找MCP图标)。
    • 选择您的服务器。
    • 你应该看看 calculate 工具。
    • 运行该工具,输入数学表达式,并在VSCode中查看结果。

安全说明

  • 只有数学函数/常量可用于求值表达式。
  • 无法访问Python内置程序或文件系统。

许可证

麻省理工学院