使用说明

项目简介

本项目实现了一个基础的MCP服务器,专注于提供数学计算功能,目前包含加法和乘法两种工具。该服务器设计用于与LLM(大型语言模型)智能体协同工作,允许智能体通过调用服务器提供的工具来执行数学运算。

主要功能点

  • MCP协议实现: 遵循 Model Context Protocol (MCP) 规范,作为后端服务器与MCP客户端进行通信。
  • 数学工具: 提供 'add' (加法) 和 'multiply' (乘法) 两个工具,用于执行基本的数学计算。
  • Stdio传输: 使用标准输入输出 (stdio) 作为默认的通信传输协议。

安装步骤

此MCP服务器是单文件Python脚本,无需传统意义上的“安装”。确保您的系统已安装 Python 环境即可运行。

服务器配置

MCP客户端需要配置以下信息才能连接到此 Math MCP 服务器。配置信息通常以 JSON 格式提供,例如在客户端的配置文件或代码中指定。

{
  "math": {
    "command": "python",
    "args": ["agent/math_server.py"],
    "transport": "stdio"
  }
}

配置参数说明:

  • 'math': 服务器名称,您可以自定义,用于在客户端配置中标识该服务器。
  • 'command': 启动服务器的命令,这里是 'python',假设您的 Python 可执行文件在系统 PATH 环境变量中。
  • 'args': 命令的参数列表,指向服务器脚本 'agent/math_server.py' 的相对路径。(请注意,此路径是相对于 MCP 客户端启动位置的。如果客户端和服务器脚本不在同一目录下,您可能需要调整此路径。)
  • 'transport': 指定通信协议为 'stdio',即标准输入输出。

基本使用方法

  1. 准备环境: 确保已安装 Python 运行环境。
  2. 启动服务器: 在终端中,导航到仓库的根目录,然后执行命令 'python agent/math_server.py' 来启动 Math MCP 服务器。服务器将通过 stdio 等待客户端连接和请求。
  3. 配置客户端: 在您的 MCP 客户端(例如 'open-mcp-client' 仓库中的 'sample_agent'),根据“服务器配置”部分提供的 JSON 信息配置 Math MCP 服务器。
  4. 运行客户端: 启动您的 MCP 客户端。客户端将根据配置连接到 Math MCP 服务器,并可以通过调用 'add' 和 'multiply' 工具来执行数学计算。

信息

分类

AI与计算