使用 TypeScript 和 MCP SDK 创建简单的回显服务器

环境准备

1. 安装 Node.js 和 npm：
   安装 Node.js（版本 18 或更高）和 npm（Node Package Manager），确保系统上已具备。

2. 创建项目目录：

   mkdir my-mcp-server
   cd my-mcp-server
   

3. 初始化 Node.js 项目：

   npm init -y
   

4. 安装 MCP TypeScript SDK：

   npm install @modelcontextprotocol/sdk
   

5. 安装 TypeScript 和其他依赖项：

   npm install typescript zod
   

6. 创建 tsconfig.json 文件：

   {
     "compilerOptions": {
       "target": "ES2020",
       "module": "NodeNext",
       "esModuleInterop": true,
       "forceConsistentCasingInFileNames": true,
       "strict": true,
       "skipLibCheck": true,
       "outDir": "./build"
     },
     "include": ["src/**/*"]
   }
   

7. 创建 src 目录和 index.ts 文件：

   mkdir src
   touch src/index.ts
   

使用 MCP SDK 创建服务器

在 src/index.ts 文件中，添加以下内容以创建一个简单的回显服务器：

#!/usr/bin/env node

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';

// 创建 MCP 服务器实例
const server = new McpServer({
  name: 'EchoServer',
  version: '1.0.0',
});

// 添加回显工具，将输入原样返回
server.tool(
  'echo',
  { message: z.string() }, // 定义输入的 Zod 模式
  async ({ message }) => ({
    content: [{ type: 'text', text: `Echo: ${message}` }],
  })
);

// 创建传输实例（本例使用 Stdio 传输）
const transport = new StdioServerTransport();

// 连接服务器和传输层
await server.connect(transport);

编译与运行

1. 编译 TypeScript 代码：

   npx tsc
   

2. 运行编译后的 JavaScript 文件：

   node build/index.js
   

3. 在 package.json 中添加以下脚本：

   "scripts": {
     "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
     "start": "node build/index.js"
   }
   

   现在，您可以运行以下命令来启动服务器：

   npm run build
   npm start
   

测试回显功能

向服务器发送一个有效的 JSON-RPC 2.0 请求以测试回显工具。例如：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": { "name": "echo", "arguments": { "message": "Hello, world!" } }
}

服务器将返回：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Echo: Hello, world!"
      }
    ]
  }
}