AgenC MCP Server

  • 项目简介
    • AgenC 集成了一个 MCP 服务器,用于把 Agent 资源、工具和提示模板等以 MCP 工具的形式暴露给 AI 客户端,LLM 客户端可以通过 JSON-RPC 请求访问并执行相关 protocol 操作。
    • 服务器侧负责会话管理、能力声明、以及对外暴露的 MCP 操作工具的注册和执行,支持通过标准化协议与多种传输通道进行通信。
  • 主要功能点
    • MCP 服务器核心:实现 MCP 规范定义的资源、工具、提示模版等操作的 JSON-RPC 交互入口,向 AI 客户端暴露协议能力。
    • 工具化暴露:将 AgenC 的内部协议能力(如注册代理、查询任务、创建任务、任务执行、账本/拷贝等操作)包装成 MCP 兼容的工具,供 LLM 调用。
    • 资源与数据访问:提供对资源(Resources)的读取与管理能力,便于 AI 客户端获取所需上下文信息。
    • Prompts 定义与渲染:提供可定制的 Prompt 模板和交互模型,支持不同的 LLM 交互模式。
    • 会话与权限管理:服务器端维护会话、版本与能力声明,确保安全、可扩展的上下文服务。
    • 多传输协议支持:设计考虑了 Stdio、SSE、WebSocket 等多种传输方式,提升集成灵活性。
    • 安全与可扩展性:通过标准化协议、工具注册和审计日志等机制,提升安全性与可维护性。
  • 安装与运行
    • 安装与构建(仓库提供的多包工作流,MCP 作为 TypeScript/Node.js 包的一部分,需在仓库根目录执行依赖安装与构建)。
    • 构建完毕后,通过 Node 运行 MCP 服务器核心分发文件(示例:node mcp/dist/index.js)。
    • 服务器启动后,即可通过配置的 MCP 客户端接入,调用暴露的 MCP 工具完成资源访问、工具执行与 Prompts 渲染等。
  • 服务器配置(MCP 客户端连接伪代码说明,客户端无需实现细节)
    • 说明:MCP 客户端需要一个 JSON 配置来连接 MCP 服务器,包含服务器名称、启动命令及参数等,用于 Claude、OpenAI 等工具接入时注册并调用服务器能力。以下为示意性 JSON 结构描述,便于理解实际使用场景(请以实际 MCP 客户端文档为准):
    • 示例配置(JSON,描述用途,不作为代码块展示): { "serverName": "agenc-dev", "command": "node", "args": ["mcp/dist/index.js"], "description": "AgenC MCP Server for AI-assisted coordination on Solana", "notes": "用于 MCP 客户端注册后通过 JSON-RPC 调用 MCP Server 提供的资源、工具与 Prompts 操作。此配置仅为客户端连接描述,客户端实现不需要使用此示例代码。" }
  • 基本使用方法
    • 启动服务器:在仓库构建产出目录下执行 Node 命令启动 MCP 服务器,例如 node mcp/dist/index.js。
    • 连接客户端:将 MCP 服务器的地址、端口及服务名称等信息配置到支持 MCP 的 AI 客户端中,使客户端可以通过 MCP 的工具调用来读取资源、执行工具、获取或渲染 Prompts。
    • 调用流程:客户端通过 MCP 发送标准化的请求,服务器接收并解析请求、执行相应的资源/工具/模板操作,返回标准 JSON-RPC 响应或通知,完成上下文服务的交互。
    • 维护与扩展:服务器侧暴露的工具可由插件化方式注册,方便扩展新的 MCP 操作,支持版本迁移和日志审计。

服务器信息