MCP サーバーサンプル

MCP サーバーサンプル

此仓库托管了一个用于AI应用中数值比较的MCP Server实现,具有自定义工具集成和客户端兼容性。

MCP数值比较工具快速上手指南

简介

这是一个实现Model Context Protocol (MCP)的服务器示例,提供数值比较等工具,帮助AI更准确地处理计算任务。

🚀 快速开始

  1. 安装依赖

    bun install
    
  2. 构建项目

    bun build
    
  3. 配置客户端

    {
      "mcpServers": {
        "number-comparison": {
          "command": "bun",
          "args": ["run", "/absolute/path/to/server/src/index.ts"],
          "disabled": false
        }
      }
    }
    

📋 系统要求

  • Bun 运行时 v1.0.0+
  • 兼容MCP的客户端(Claude桌面版、Cline、Cursor等)

💡 使用示例

<use_mcp_tool>
  <server_name>number-comparison</server_name>
  <tool_name>compare-numbers</tool_name>
  <arguments>
    { "number1": 42, "number2": 24 }
  </arguments>
</use_mcp_tool>

结果: The larger number is: 42

⚠️ 注意事项

  • 配置中必须使用绝对路径
  • 更改配置后需重启客户端
  • 谨慎使用autoApprove功能

🛠️ 添加自定义工具

  1. 创建工具文件
  2. server/src/index.ts中注册:
server.tool(
  "new-tool",
  {
    param1: z.string().describe("参数说明"),
    param2: z.number().min(0)
  },
  async ({ param1, param2 }) => {
    // 实现逻辑
    return {
      content: [{ type: 'text', text: '结果' }]
    };
  }
);

查看完整文档获取更多信息和高级配置选项。