ACK Protocol MCP Server

关键词

AI上下文服务JSON-RPCSSE工具调用资源查询

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现了一个 MCP 服务端，使用 Next.js/SSE 传输模式，提供标准化的 JSON-RPC 请求/响应来对接 LLM 客户端，核心能力包括工具调用、资源查询、以及代理外部数据源的能力。服务端对外提供 /api/mcp 端点，客户端可通过 GET 建立 SSE 连接、POST 发起工具调用与查询请求、以及 OPTIONS 进行跨域预检。

  • 主要功能点

    • 通过 SSE 传输实现 MCP 通信：服务器端会建立持续的 SSE 流，向客户端发送初始化通知并保持心跳。
    • 提供 5 种 MCP 工具（tools）：search_agents、get_agent、get_reputation、get_feedbacks、leaderboard，支持通过 JSON-RPC 风格请求调用。
    • 资源与数据代理：内部通过对接 8004scan 的 API 获取代理的代理信息、信誉、反馈等数据，并对外暴露统一的接口。
    • 异步与容错设计：包括对 API 请求的错误处理、超时、以及对上游错误码的映射返回。
    • CORS 与 API 兼容：提供 OPTIONS 处理，便于客户端进行跨域请求预检。

  • 安装步骤

    1. 将代码克隆到本地或服务器环境，并进入项目目录。
    2. 安装依赖：npm install
    3. 启动开发服务器：npm run dev
    4. MCP 服务器地址（示例，实际部署请按环境配置）: http(s)://your-host/api/mcp

  • 服务器配置（MCP 客户端所需配置，JSON 格式，包含 server name、command、args 等，注释仅为说明，实际客户端无需使用） { "serverName": "ACK Protocol MCP Server", "description": "MCP 服务端，基于 SSE 的 JSON-RPC 暴露，提供 agent 数据、信誉、反馈与排行榜查询等工具", "endpoint": "http://<your-host>/api/mcp", "transport": "SSE", "command": "npm", "args": ["run", "dev"], "workingDirectory": "<项目根路径>", "notes": [ "客户端将通过 SSE 建立连接以接收初始化信息和后续通知", "MCP 工具调用以 JSON-RPC 2.0 风格传输，路由到 /api/mcp 的 POST 请求", "如需生产环境，需结合实际部署进行适配（域名、证书、代理等）" ] }

  • 基本使用方法

    • 启动后，客户端连接到 /api/mcp 并发送 JSON-RPC 请求来调用工具（如 search_agents、get_agent 等）或请求其他 MCP 功能。
    • 客户端收到服务器的 JSON-RPC 响应即可解析结果并进行后续处理。
    • 服务器会对外部数据源进行代理查询、必要时进行错误处理与重试，确保对接的稳定性。

服务器信息

访问项目