项目简介

本项目 'Calculator' 是一个基础的 MCP (Model Context Protocol) 服务器,它演示了如何使用 'mcp-framework' 框架构建 MCP 应用后端。该服务器提供简单的计算和消息处理工具,旨在帮助开发者快速上手 MCP 服务器的开发。

主要功能点

  • 加法工具 (add_tool): 接收两个数字作为输入,计算它们的和并返回结果。
  • 消息处理工具 (say_dev_tool): 接收用户消息,并在消息前添加 "Dev Dev Dev: " 前缀后返回。
  • 基于 SSE 传输: 使用 Server-Sent Events (SSE) 协议与 MCP 客户端进行通信。

安装步骤

  1. 克隆仓库: 打开终端,执行命令 'git clone https://github.com/QuantGeekDev/mcp-add-sse' 克隆代码仓库到本地。
  2. 进入项目目录: 执行 'cd mcp-add-sse' 进入项目目录。
  3. 安装依赖: 执行 'npm install' 安装项目所需的依赖包。
  4. 构建项目: 执行 'npm run build' 编译 TypeScript 代码,生成可执行的 JavaScript 文件。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端(例如 Claude Desktop),您需要提供服务器的启动命令和参数。以下是 Claude Desktop 客户端的 'claude_desktop_config.json' 配置文件示例,展示了如何配置 'calculator' 服务器:

{
  "mcpServers": {
    "calculator": {
      "command": "node",
      "args": ["/absolute/path/to/calculator/dist/index.js"]
    }
  }
}

配置参数说明:

  • 'server name': 'calculator' - 服务器名称,在客户端配置中用于标识该服务器。
  • 'command': '"node"' - 启动服务器的命令,这里使用 Node.js 运行时环境。
  • 'args': '["/absolute/path/to/calculator/dist/index.js"]' - 命令参数,指向编译后的服务器入口文件 'dist/index.js' 的绝对路径请务必将 '/absolute/path/to/calculator/dist/index.js' 替换为您本地仓库 'calculator/dist/index.js' 文件的实际绝对路径。 您可以通过在终端中 'cd' 到 'calculator' 目录,然后执行 'pwd' 命令获取当前目录的绝对路径,再拼接上 '/dist/index.js'。

基本使用方法

  1. 启动服务器: 在项目根目录下,执行命令 'node dist/index.js' 启动 MCP 服务器。服务器默认监听 1337 端口,并在终端输出 'MCP Calculator server running on port 1337' 表示启动成功。
  2. 配置 MCP 客户端: 根据您的 MCP 客户端(如 Claude Desktop)的文档,配置 MCP 服务器连接信息。 关键是将上面提供的 JSON 配置添加到客户端的配置文件中,并确保 'args' 中的路径已正确替换为 'dist/index.js' 的绝对路径。
  3. 在 MCP 客户端中使用工具: 成功配置并连接服务器后,您可以在 MCP 客户端中调用服务器提供的工具,例如 'add_tool' 和 'say_dev_tool'。具体调用方式请参考 MCP 客户端的使用说明。

信息

分类

AI与计算