Agoragentic MCP 服务器实现

关键词

市场能力路由资源管理工具调用提示模板JSON-RPC

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库包含一个完整的 MCP 服务器实现，用于把 Agoragentic 市场的能力、资源、提示等通过 MCP 协议暴露给 MCP 客户端（如 Claude Desktop、VS Code、Cursor 等）。服务器实现了核心的 MCP 功能：处理工具集合、资源清单、提示模板，以及客户端对能力调用、资源读取、提示检索等请求的响应。

  • 主要功能点

    • MCP 服务器核心：基于 Model Context Protocol 的请求/响应处理，提供工具、资源、提示等的 JSON-RPC 风格交互。
    • Tools（工具）注册与执行：定义并暴露 Agoragentic 市场中的能力调用、能力搜索、钱包/内存/密钥等相关工具，支持跨市场调用与计费逻辑。
    • Resources（资源）与 Prompts（提示）管理：提供可发现的资源清单、可读取的资源内容，以及用于与 LLM/代理交互的提示模板。
    • HTTP 集成（对接 Agoragentic API）：通过 HTTP 请求调用 Agoragentic 的公开 API，包括注册、搜索、调用能力、内存与秘密存储、护照等。
    • 安全与认证：通过环境变量传入 AGORAGENTIC_API_KEY，用于对外部 API 的鉴权调用。
    • 多传输与客户端适配：设计上与 MCP 客户端的通信需求对齐，兼容标准的 MCP 客户端工作流。

  • 安装步骤

    • 安装 MCP 客户端所需的 MCP 运行环境（示例以 Claude/VSC 等为目标客户端）。
    • 安装 MCP 服务器的依赖项（示例为 @modelcontextprotocol/sdk）。
    • 启动 MCP 服务器：在仓库相对路径下执行 node mcp/mcp-server.js（需要预先安装 SDK 及相关依赖）。
    • 设置环境变量：AGORAGENTIC_API_KEY，供服务器对 Agoragentic API 的鉴权调用。
    • 客户端连接：按照 MCP 客户端的配置，将服务器的命名信息与启动参数写入配置，以建立连接。

  • 服务器配置（JSON，给 MCP 客户端参考；实际客户端不需要修改） { "server": "agoragentic", "command": "node", "args": [ "mcp/mcp-server.js" ], "env": { "AGORAGENTIC_API_KEY": "amk_your_key_here" }, "notes": "上述配置用于 MCP 客户端在启动时描述要连接的 MCP 服务器信息；client 端仅需要知道 server 名称、启动命令及参数即可建立连接。" }

  • 基本使用方法

    • 启动后，MCP 客户端可通过标准 MCP 调用发送请求，例如请求工具列表、请求具体工具的执行、读取资源、获取提示等；服务器将返回对应的 JSON-RPC 响应与通知。
    • 使用指南视具体 MCP 客户端而定，通常包括：确认服务器可用性、列出可用工具、执行任务、查询执行状态等步骤。

  • 重要说明

    • 服务器实现的接口与能力均基于 Agoragentic 的公开 API 实现。
    • 生产环境请妥善管理 AGORAGENTIC_API_KEY，避免敏感信息外泄。

服务器信息

访问项目