agentdocs

Name: agentdocs
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords开发工具01 周前更新

代码仓库

关于 agentdocs

agentdocs 是用于检索 IMBA Agent 平台已发布文档的转发型 MCP 服务，适合需要查询平台事实、用例、等级政策、目录归属或公开文档的 Agent 与客户端。它仅提供只读检索，不执行钱包操作。

主要功能

01提供六种只读文档工具
02检索平台事实与用例
03查询等级政策和目录归属
04列出并获取允许访问的公开文档
05转发上游工具结果

适用场景

01回答 IMBA Agent 政策相关问题
02查找适用于文档所述用例的工具
03确认 MCP 在目录中的归属
04获取已发布的公开文档页面

MCP 相关

它通过 MCP 服务提供六种只读工具，并将工具调用转发至 IMBA 文档端点。它不提供钱包操作能力。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-agentdocs": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/agentdocs"
      ]
    }
  }
}

启动命令npx -y @reneturcios/agentdocs

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/agentdocs0.1.0stdio

ocighcr.io/cloudcorprecords/agentdocs:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

此工具无需参数。

详细介绍

agentdocs

agentdocs 根据已发布的文档回答有关 IMBA Agent 平台的问题，包括权威的 Agent 事实、用例指南、层级政策、各个 MCP 在目录中的归属、公开文档 URL 列表，以及各个允许访问的公开文档 URL 的内容。

它是一个转发客户端，不是钱包。文档介绍的产品是预付卡／加密货币 Agent 钱包，但此软件包仅提供文档检索功能——与原始文档服务公开的六个只读工具相同——不具备任何操作、注册、存款、购买或提现功能。每个捕获的工具描述都会重申，此服务不会转移资金。get_public_url 与其他工具一样会被转发；其允许列表由上游强制执行。

工具

get_agent_facts — 规范的预付费 Agent 政策和目录：Visa 预付卡、eSIM、礼品卡、KYT 地址筛查、USDT TRC-20、禁止使用的渠道、层级。无参数。
get_agent_use_cases — Agent 可以购买什么的指南，以及各类任务对应的 MCP 工具。无参数。
get_tier_policy — Tier 0 与 1+：兑换和提现政策。无参数。
get_catalog_placement — 哪些目录收录文档 MCP，哪些收录消费 MCP。无参数。
get_public_url — 获取一个允许访问的公开文档 URL。必填：url（允许列表中的绝对 https://imbawallet.com URL）。
list_docs_urls — 列出公开的 Agent URL：HowTo、用例、层级、发现、OpenAPI、MCP 端点。无参数。

tools/list 由本地提供，其内容来自从已发布的远程服务逐字捕获的工具字面值。tools/call 会转发至上游，结果——content、structuredContent 以及任何 isError 标志——也会逐字返回，因此上游拒绝请求（例如 get_public_url 的允许列表错误）会原样传递。

配置

IMBA_DOCS_MCP_URL（可选，标注为重建项）— 覆盖文档端点。默认值为 https://imbawallet.com/mcp/docs。

故障会以本次重建项目自己的错误文本呈现（标注为重建项）：agentdocs error: ... — JSON-RPC 错误会包含上游消息，HTTP 故障会包含状态码，无法解析的响应则会报告为格式错误的响应。

转发机制

首次转发调用时，客户端会 POST 一个 initialize 请求（protocolVersion 2025-03-26，clientInfo name agentdocs，version 0.1.0），捕获返回的 Mcp-Session-Id 响应标头（如果有），POST notifications/initialized，随后 POST tools/call 请求，并在捕获到会话标头时将其附上。该会话会在进程运行期间复用。每个 POST 都会携带 Content-Type: application/json 和 Accept: application/json, text/event-stream，响应可以是普通 JSON 或 SSE（data: 行）。

CLI

每个工具都是一个子命令，接受一个 JSON 参数字符串：

npx @reneturcios/agentdocs get_agent_facts '{}'
npx @reneturcios/agentdocs get_public_url '{"url":"https://imbawallet.com/agent/howto"}'
npx @reneturcios/agentdocs list_docs_urls '{}'
npx @reneturcios/agentdocs --version

输出为转发结果内容的 JSON。退出码：成功时为 0，结果中包含 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/agentdocs mcp

MCP 客户端配置：

{
  "mcpServers": {
    "agentdocs": {
      "command": "npx",
      "args": ["-y", "@reneturcios/agentdocs", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/agentdocs
docker run --rm ghcr.io/cloudcorprecords/agentdocs list_docs_urls '{}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source