Jakegaylor Com MCP Server

🚀 带MCP支持的HTTP服务器

本项目是一个使用Express和TypeScript构建的HTTP服务器，它不仅能提供网页服务，还具备模型上下文协议（MCP）端点，为大型语言模型与外部数据和功能交互提供了标准化的解决方案。

🚀 快速开始

本服务器使用Express和TypeScript构建，同时提供网页服务和模型上下文协议（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