关键词

计算器数学工具LLM上下文协议工具调用

使用说明

项目简介

本项目是一个简单的MCP服务器示例，它使用 'mcp-sdk' 库创建，并提供基本的数学计算工具（加法、减法、乘法）。此服务器旨在演示如何构建一个能够与LLM客户端通过 MCP 协议进行交互的后端应用。

主要功能点

  • 提供计算工具: 实现了加法 ('add')、减法 ('subtract') 和乘法 ('multiply') 三个工具，LLM客户端可以通过MCP协议调用这些工具进行数学运算。
  • 基于 'mcp-sdk' 构建: 使用 'mcp-sdk' 简化了 MCP 服务器的开发过程，并遵循 MCP 协议规范。
  • Stdio 传输协议: 服务器和客户端之间通过标准输入/输出流 (Stdio) 进行通信，方便本地部署和测试。
  • 集成 OpenAI 客户端: 提供了一个 MCP 客户端示例 ('mcp_client.py')，展示了如何使用 OpenAI 的 'chat.completions' API 与 MCP 服务器集成的工具进行交互。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/OmgiKikov/MCP_Example.git
cd MCP_Example

  2. 安装依赖:

    pip install -r requirements.txt

  3. 配置 OpenAI API 密钥:

    • 创建 '.env' 文件在项目根目录下。
    • 在 '.env' 文件中添加您的 OpenAI API 密钥： 
      OPENAI_API_KEY=your_api_key_here

服务器配置

MCP 服务器无需额外配置。客户端需要配置服务器的启动命令和参数以连接到服务器。以下是客户端连接到此 MCP 服务器所需的配置信息：

{
  "serverName": "WorkshopDemo",
  "command": "python3",
  "args": ["mcp_server.py"]
}

配置参数说明:

  • 'serverName': 服务器名称，本示例为 "WorkshopDemo"。
  • 'command': 启动服务器的命令，这里使用 'python3' 解释器。
  • 'args': 传递给启动命令的参数，这里指定运行 'mcp_server.py' 脚本。

基本使用方法

  1. 启动客户端: 打开终端，进入项目目录，运行客户端脚本：

    python mcp_client.py

  2. 与助手对话: 客户端启动后，您可以在命令行中输入数学表达式，例如：

    • 'сложи 5 и 3' (加 5 和 3)
    • 'вычти из 10 число 4' (10 减去 4)
    • 'умножь 6 на 7' (6 乘以 7)

    客户端会将您的请求发送给 OpenAI 模型，模型会判断是否需要调用 MCP 服务器提供的计算工具来完成计算，并将结果返回给您。

  3. 结束会话: 在对话中输入 'выход' (退出) 即可结束客户端程序。

信息

分类

AI与计算

访问项目