关键词

计算器工具数学服务MCPSSE传输API服务

使用说明

项目简介

本仓库包含一个实现了Model Context Protocol (MCP) 的示例服务器，专注于提供基础的数学计算功能。该服务器是另一个演示项目的一部分，但可以独立运行，作为MCP客户端（例如LLM）调用外部工具的一个实例。

主要功能点

  • 数学工具: 提供加、减、乘、除、乘方、平方根、取模、绝对值等多种数学计算工具。
  • MCP实现: 符合Model Context Protocol规范，通过标准协议暴露工具能力。
  • SSE传输: 支持Server-Sent Events (SSE) 作为客户端与服务器之间的传输协议。

安装步骤

  1. 克隆仓库： 
    git clone https://github.com/roryp/contentsafety.git
  2. 进入包含MCP服务器代码的'calculator'目录： 
    cd contentsafety/calculator
  3. 使用Maven构建项目并安装依赖： 
    mvn install

服务器配置 (供MCP客户端参考)

MCP客户端需要以下信息来连接和启动此计算器服务器进程。请注意，这仅为客户端配置时所需的描述性信息，实际启动服务器需要在命令行中操作。

{
  "name": "CalculatorService",
  "command": "mvn",
  "args": [
    "spring-boot:run"
  ],
  "workingDirectory": "calculator",
  "environmentVariables": {},
  "transport": {
    "type": "http/sse",
    "url": "http://localhost:8080/sse"
  }
}
  • 'name': 服务器的标识名称。
  • 'command': 用于启动服务器进程的命令（例如 'mvn'）。
  • 'args': 启动命令的参数（例如 'spring-boot:run'）。
  • 'workingDirectory': 启动命令应在哪个目录下执行 (必须在克隆仓库后的 'calculator' 目录执行)。
  • 'environmentVariables': 启动进程所需的环境变量（本示例通常不需要特定环境变量）。
  • 'transport':
    • 'type': 采用的MCP传输协议类型。
    • 'url': 服务器暴露的MCP端点URL（本示例默认为'http://localhost:8080/sse'）。

基本使用方法

  1. 按照上述安装步骤准备项目。
  2. 确保当前目录位于 'contentsafety/calculator'。
  3. 执行以下命令启动MCP计算器服务器： 
    mvn spring-boot:run
    服务器启动后，将监听默认端口（通常是8080），并通过 '/sse' 路径暴露其计算器工具服务。
  4. 您可以使用兼容MCP协议的客户端（例如 LangChain4j 的 MCP 客户端）连接到 'http://localhost:8080/sse' 端点，发现并调用服务器提供的数学计算工具。

信息

分类

AI与计算

访问项目