AGILEX Docs

AGILEX Docs MCP

AgileX Robotics（松灵机器人） 官方产品文档——包括 piper、pika、 nero、ranger、limo、scout、bunker、hunter、tracer、 umr、cobot_magic 和 aloha 的用户手册、CAN 2.0B 协议参考、固件说明、 SDK 技术文章和售后常见问题。

在为 AgileX 硬件编写集成代码之前，请让 AI 编码助手连接此服务，以便它参考 真实手册，而不是猜测波特率、帧格式或引脚定义。

此代码库是公开的服务契约，而非实现。 它记录了端点、工具签名以及每种客户端配置。 索引服务本身不公开，和 Cloudflare、Sentry 与 Linear 发布其远程 MCP 服务的方式一样。

端点

无需 API 密钥、OAuth 或本地进程。只要你的客户端支持 Streamable HTTP， 就只需要这个 URL。

快速开始

# Claude Code
claude mcp add --transport http agilex-docs https://service.agilex.ai/agilex-docs/mcp

# Codex CLI  (writes ~/.codex/config.toml)
codex mcp add agilex-docs --url https://service.agilex.ai/agilex-docs/mcp

Cursor — 一键配置：

cursor://anysphere.cursor-deeplink/mcp/install?name=agilex-docs&config=eyJ1cmwiOiJodHRwczovL3NlcnZpY2UuYWdpbGV4LmFpL2FnaWxleC1kb2NzL21jcCJ9

任何可读取 mcpServers 的客户端（Claude Desktop、Cline、Windsurf、Cherry Studio、 Continue、Zed、LibreChat、Dify 等）：

{
  "mcpServers": {
    "agilex-docs": {
      "url": "https://service.agilex.ai/agilex-docs/mcp"
    }
  }
}

各客户端的完整配置说明：docs/CLIENTS.md。

工具

提供四种只读工具。工具名称特意采用 verb_noun 格式，让模型无需先阅读架构即可 选择合适的工具。

search_docs 会返回 doc_id、title、space、url、score、chars 和 片段。将 doc_id 传入 get_doc。如果响应中包含 truncated: true， 请使用 next_offset 再次调用 get_doc。

响应格式

// search_docs("piper CAN 波特率")
{
  "query": "piper CAN 波特率",
  "count": 3,
  "results": [
    {
      "doc_id": "01a06659-2d4e-7029-bc64-63f9352b34a6",
      "title": "PIPER X 用户手册(CN)",
      "space": "AGX-机械臂产品手册",
      "url": "https://kb.agilex.ai/s/agx-robot-arm-products-cn-en/p/pWVjLJsYc0",
      "score": 18.42,
      "chars": 13264,
      "snippet": "...CAN通信标准采用的是CAN2.0B标准，通讯波特率为1000K..."
    }
  ]
}

// get_doc(doc_id="01a06659-…", max_chars=2000)
{
  "doc_id": "01a06659-2d4e-7029-bc64-63f9352b34a6",
  "title": "PIPER X 用户手册(CN)",
  "url": "https://kb.agilex.ai/s/agx-robot-arm-products-cn-en/p/pWVjLJsYc0",
  "chars": 13264,
  "offset": 0,
  "truncated": true,
  "next_offset": 2000,
  "content": "..."
}

url 始终指向原始 Docmost 页面——请引用该链接，以便用户核实。

客户端配置

{
  "mcpServers": {
    "agilex-docs": {
      "url": "https://service.agilex.ai/agilex-docs/mcp"
    }
  }
}

# all projects
claude mcp add --transport http agilex-docs https://service.agilex.ai/agilex-docs/mcp

# this project only (writes .mcp.json, can be committed)
claude mcp add --scope project --transport http agilex-docs https://service.agilex.ai/agilex-docs/mcp

claude mcp list

codex mcp add agilex-docs --url https://service.agilex.ai/agilex-docs/mcp

[mcp_servers.agilex-docs]
url = "https://service.agilex.ai/agilex-docs/mcp"

- insert:
    - id: agilex-docs
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: agilex-docs
        transport: streamable-http
        url: https://service.agilex.ai/agilex-docs/mcp

dsh web --patch "$PWD/examples/agilex-docs.cordis.yml"

{
  "mcpServers": {
    "agilex-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://service.agilex.ai/agilex-docs/mcp"]
    }
  }
}

{
  "servers": {
    "agilex-docs": {
      "type": "http",
      "url": "https://service.agilex.ai/agilex-docs/mcp"
    }
  }
}

示例提示词

我需要为 piper 机械臂编写 CAN 控制脚本。首先调用 search_docs 搜索 “piper CAN 报文”，然后对最佳结果调用 get_doc，并根据手册中的 帧格式和波特率编写代码。在注释中引用手册 URL。

我们的 ranger mini 出现底盘错误码。请搜索售后 FAQ 中的 错误码，引用故障排查步骤并附上页面链接。

由于服务包含一个 instructions 区块，指示模型先搜索并引用 URL，因此通常无需额外提示即可完成工作流。

范围与数据

语料库由标记为 「互联网所有人可访问」 的 Docmost 空间构建，这些内容已在 https://kb.agilex.ai 上公开。标记为 内部 / 非对外 的空间无法访问： 爬虫只使用 Docmost 的匿名分享端点，从不进行身份验证，因此即使发生错误，内部内容也不会泄露。

新的公开空间会自动纳入；撤销分享的内容会在下一次同步时移除。

速率限制

如需更高配额或专用端点，请联系 AgileX（参见反馈）。

限制

• 只读。 不提供写入工具；此处的任何内容都无法移动机器人。
• 图片不会内嵌。 Docmost 会为附件 URL 签发较短的有效期，因此快照中会留下失效链接。图片显示为 （图：caption）；打开页面的 url 即可查看。
• 公开空间中的二进制附件（PDF/XLSX）不会解析 — 仅处理页面正文。
• 词法匹配，而非语义匹配。使用 BM25 + CJK 二元组。若未匹配到某个词，请换种说法。
• 每次查询一个产品系列效果最佳；跨产品问题需要 多次搜索。

验证是否正常

# health
curl -s https://service.agilex.ai/agilex-docs/health | jq

# MCP handshake
curl -s -X POST https://service.agilex.ai/agilex-docs/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}' | jq

# full round trip (initialize → tools/list → tools/call)
./scripts/smoke-test.sh

仓库结构

README.md                    this file
server.json                  official MCP Registry manifest
LICENSE                      MIT (documentation + manifest)
docs/CLIENTS.md              per-client setup, long form
examples/                    copy-paste configs per client
scripts/smoke-test.sh        end-to-end check against the live endpoint

反馈

文档缺失或有误 → 通过 https://www.agilex.ai/ 联系 AgileX 支持，并附上页面 URL。

关于此仓库的问题（清单、文档、客户端配置）→ 在此处提交 issue。 关于文档内容的问题 → 联系支持渠道，因为文档存放在 内部知识库中，此仓库无法编辑这些内容。

许可证

MIT — 详见 LICENSE。此许可证适用于本仓库中的文档和清单。通过 MCP 提供的文档内容仍归 AgileX Robotics 所有。