low-code-mcp-stdio

Low-Code MCP Server

这是一个基于 Model Context Protocol (MCP) 的服务器项目，支持与 Cursor 等 AI 编辑器进行流式通信。

项目架构

核心组件

• McpServer: MCP 服务器核心
• StreamableHTTPServerTransport: 支持流式传输的 HTTP 传输层
• Express Server: HTTP 服务器框架
• 工具注册系统: 可扩展的工具注册机制

流式通信实现

1. 传输层流式支持

项目使用 StreamableHTTPServerTransport 来实现流式通信：

const transport = new StreamableHTTPServerTransport({
  sessionIdGenerator: () => randomUUID(),
  onsessioninitialized: (sessionId) => {
    transports[sessionId] = transport;
  },
});

2. 会话管理

每个 Cursor 连接都有唯一的 sessionId，通过会话管理确保流式通信的连续性：

const transports: { [sessionId: string]: StreamableHTTPServerTransport } = {};

3. 工具实现

工具通过标准的 MCP 接口返回内容，流式传输由传输层自动处理：

server.registerTool(
  "tool-name",
  {
    description: "工具描述",
    inputSchema: {
      // 输入参数定义
    }
  },
  async (args, { signal }) => {
    // 工具逻辑实现
    return {
      content: [
        {
          type: "text",
          text: "返回的内容"
        }
      ]
    };
  }
);

如何给 Cursor 以 Stream 形式返回结果

1. 自动流式传输

MCP 协议本身支持流式传输，当使用 StreamableHTTPServerTransport 时：

• 工具返回的内容会自动以流式方式传输给 Cursor
• 不需要在工具层面实现特殊的流式逻辑
• 传输层会处理分块传输和实时推送

2. 工具实现要点

// 支持取消操作
async ({ message }, { signal }) => {
  if (signal?.aborted) {
    // 处理取消逻辑
    return;
  }
  
  // 工具逻辑
  return {
    content: [
      {
        type: "text",
        text: "处理结果"
      }
    ]
  };
}

3. 流式传输的优势

• 实时响应: Cursor 可以实时显示工具执行结果
• 用户体验: 用户无需等待完整结果，可以立即看到部分输出
• 资源效率: 避免长时间阻塞，支持取消操作

运行项目

# 安装依赖
pnpm install

# 开发模式运行
pnpm dev

# 生产模式运行
pnpm start

# 测试服务器
pnpm test

服务器将在 http://localhost:8000/low-code-mcp 启动。

在 Cursor 中配置

• 打开 Cursor 设置
• 找到 MCP 配置部分
• 添加以下配置：

{
  "mcpServers": {
    "low-code-mcp": {
      "command": "node",
      "args": ["/path/to/your/project/dist/index.js"],
      "env": {
        "NODE_ENV": "production"
      }
    },
    "low-code-mcp-streamable": {
      "transport": "http",
      "url": "http://localhost:8000/low-code-mcp?name=1",
      "name": "low-code-mcp",
      "version": "1.0.0"
    },
  }
}

• 重启 Cursor
• 现在你可以在 Cursor 中使用以下工具：
  • hello-world: 获取一个打招呼的方式
  • stream-demo: 演示流式返回结果的工具
  • advanced-stream: 高级流式工具，演示长时间任务和进度更新
  • real-time-data: 实时数据流工具，模拟数据采集

工具扩展

要添加新工具，只需：

• 在 src/tools/ 目录下创建新的工具文件
• 实现工具逻辑
• 在 src/index.ts 中注册工具

MCP 协议特点

• 标准化: 遵循 MCP 协议标准
• 可扩展: 支持动态工具注册
• 流式支持: 原生支持流式数据传输
• 会话管理: 支持多会话并发处理