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