MCP Server Demo

这是一个支持多种传输方式的 MCP (Model Context Protocol) Server演示项目，使用 TypeScript 和 Nodejs 构建，支持 STDIO、SSE 和 StreamableHttp 三种传输方式。

功能特性

• STDIO 传输: 标准输入输出传输，适合命令行工具集成
• SSE 传输: Server-Sent Events 传输，适合 Web 应用实时通信
• StreamableHttp 传输: 可流式传输的 HTTP 传输，适合 Web API 集成
• 工具支持: 内置加法工具演示
• 命令行界面: 使用 Commander.js 提供友好的命令行界面
• 健康检查: 内置健康检查和服务信息端点
• CORS 支持: 内置跨域请求支持
• 优雅关闭: 优雅关闭服务器

安装依赖

pnpm install

构建项目

pnpm run build

使用方法

查看帮助

node build/index.js --help

输出：

Usage: mcp-server-demo [options] [command]

A demo MCP server

Options:
  -V, --version      display version number
  -h, --help         display help for command

Commands:
  stdio              Start MCP server with STDIO transport
  sse [options]      Start MCP server with SSE transport
  http|streamable    Start MCP server with StreamableHttp transport
  help [command]     display help for command

1. STDIO 传输

node build/index.js stdio

这是标准的 MCP 传输方式，适合与 Claude Desktop、Cursor 等客户端集成。

2. SSE 传输

node build/index.js sse
# 或指定端口
node build/index.js sse --port 3000

启动后可以访问：

• SSE 端点: http://localhost:3000/sse
• 消息端点: http://localhost:3000/message
• 健康检查: http://localhost:3000/health
• 服务信息: http://localhost:3000/info

3. StreamableHttp 传输

node build/index.js http
# 或者使用别名
node build/index.js streamable --port 3000

启动后可以访问：

• MCP 端点: http://localhost:3000/mcp
• 健康检查: http://localhost:3000/health
• 服务信息: http://localhost:3000/info

API 端点

健康检查

curl http://localhost:3000/health

响应：

{
  "status": "ok",
  "transport": "sse",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

服务信息

curl http://localhost:3000/info

响应：

{
  "name": "mcp-server-demo",
  "version": "0.0.1",
  "description": "A demo MCP server",
  "transport": "sse",
  "endpoints": {
    "health": "/health",
    "info": "/info",
    "sse": "/sse"
  },
  "timestamp": "2024-01-01T00:00:00.000Z"
}

SSE 连接

使用 JavaScript 连接 SSE：

const eventSource = new EventSource('http://localhost:3000/sse');

eventSource.onmessage = function(event) {
  const data = JSON.parse(event.data);
  console.log('Received:', data);
};

eventSource.onerror = function(error) {
  console.error('SSE error:', error);
};

发送消息到 SSE

curl -X POST http://localhost:3000/message?sessionId=<session-id> \
  -H "Content-Type: application/json" \
  -d '{"method": "tools/list"}'

工具演示

项目内置了一个加法工具，演示 MCP 工具的使用：

// 位于 src/tools/add.ts
export function registerAddTool(server: McpServer) {
  server.registerTool("add", {
    title: "Addition Tool",
    description: "Add two numbers",
    inputSchema: { a: z.number(), b: z.number() }
  }, async ({ a, b }) => ({
    content: [{ type: "text", text: String(a + b) }]
  }));
}

开发说明

项目结构

src/
├── index.ts        # 主服务器文件
└── tools/
    └── add.ts      # 加法工具实现

技术栈

• TypeScript: 类型安全的 JavaScript
• Commander: 命令行参数解析
• Node.js HTTP: 内置 HTTP 服务器
• MCP SDK: Model Context Protocol 实现
• Zod: 类型验证库

添加新工具

1. 在 src/tools/ 目录下创建新的工具文件
2. 在 src/index.ts 中的 createMcpServer 函数中注册新工具

示例：

// src/tools/multiply.ts
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";

export function registerMultiplyTool(server: McpServer) {
  server.registerTool("multiply", {
    title: "Multiplication Tool",
    description: "Multiply two numbers",
    inputSchema: { a: z.number(), b: z.number() }
  }, async ({ a, b }) => ({
    content: [{ type: "text", text: String(a * b) }]
  }));
}

然后在 src/index.ts 中注册：

import { registerMultiplyTool } from "./tools/multiply.js";

function createMcpServer(): McpServer {
  const server = new McpServer({
    name: MCP_INFO.name,
    version: MCP_INFO.version
  });
  registerAddTool(ser

... [View full README on GitHub](https://github.com/isboyjc/mcp-server-demo#readme)