带MCP支持的HTTP服务器

一个使用Express和TypeScript构建的HTTP服务器，同时提供网页服务和模型上下文协议（MCP）端点。

特性

• 同时支持Web和MCP功能的HTTP服务器
• 使用现代流式传输实现无状态MCP服务器
• 使用TypeScript确保类型安全
• 使用Express.js处理HTTP请求

依赖条件

• Node.js 18+
• npm或yarn

安装

# 克隆仓库（或下载）
git clone https://github.com/your-username/jakegaylor-com-mcp-server.git
cd jakegaylor-com-mcp-server

# 安装依赖项
npm install

开发

# 构建TypeScript代码
npm run build

# 以开发模式运行，带有自动重新加载
npm run dev

# 运行测试（当添加时）
npm test

服务器结构

src/
  ├── index.ts                # 应用程序主入口点
  ├── express.ts              # HTTP服务器配置
  ├── stdio.ts                # STDIO服务器配置
  ├── config.ts               # 服务器配置
  └── types.ts                # TypeScript类型定义

可用端点

该服务器支持多个端点：

• Web（GET /）：提供网页服务
• MCP（POST /mcp）：实现MCP协议功能

MCP 功能

MCP端点实现了三个MCP组件：

• 资源：echo://{message} - 返回消息作为资源
• 工具：echo - 将提供的消息回显为工具响应
• 提示：echo - 使用提供的消息创建用户提示

MCP 协议

该服务器实现了模型上下文协议（MCP），这是一种标准化方式，用于大型语言模型与外部数据和功能交互。它提供了一个无状态的API端点，响应JSON-RPC请求。

API 使用方法

向/mcp发送POST请求，并包含JSON-RPC负载：

初始化

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {
        "roots": {
          "listChanged": true
        },
        "sampling": {}
      },
      "clientInfo": {
        "name": "ExampleClient",
        "version": "1.0.0"
      }
    }
  }'

调用回显工具

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "echo",
      "arguments": {
        "message": "Hello, World!"
      }
    },
    "id": 1
  }'

许可证

ISC

再生成fly部署密钥

该令牌是使用以下命令创建的：

fly tokens create deploy --name gh-jakegaylor-com-mcp-server --expiry 2160h