a2asearch-mcp

A2ASearch MCP

帮助你的助手查找工具、检查工具，并了解如何设置。

通过 MCP 客户端或终端搜索 A2ASearch 目录，查找 MCP 服务、A2A Agent、编码 Agent、CLI 工具和 Agent 技能。A2ASearch 可免费查询，无需 API 密钥。个别服务可能需要凭据或付费。

试用实用工作流

向助手提问：

查找用于从 PDF 中提取表格的 MCP 服务。比较它们文档中列出的要求，然后向我展示其中一个服务的设置说明。如果定价或身份验证信息未知，请告知我。

助手可以按以下顺序操作：

search_agents({"query":"PDF","type":"MCP Server","limit":3})
    → names, capabilities, source links and slugs
get_agent({"slug":"<slug returned by search>"})
    → description, README, documentation and repository links
get_setup({"slug":"<same returned slug>"})
    → setup excerpts, quoted JSON examples and next steps

例如，Doc2X MCP 条目链接到一个代码仓库，其中的 README 包含设置说明，以及带有 DOC2X_API_KEY 占位符的配置示例。get_setup 会检索这些说明作为源材料；它不会创建凭据、安装软件包或运行软件包。

安装

需要 Node.js 22 或更高版本。CI 会测试 Node.js 22 和 24。

对于 Claude Desktop，将此条目添加到 claude_desktop_config.json。对于 Cursor，请使用 .cursor/mcp.json。将其合并到现有配置中：

{
  "mcpServers": {
    "a2asearch": {
      "command": "npx",
      "args": ["-y", "a2asearch-mcp"]
    }
  }
}

支持本地 stdio MCP 服务的其他客户端可以使用参数 -y a2asearch-mcp 启动命令 npx；请使用客户端文档中说明的配置格式。

为确保安装可复现，请在参数中固定软件包版本，例如在 [email protected] 发布后使用该版本。若要在发布前测试此代码库，请运行 npm ci，并将命令配置为 node，同时指定本仓库中 index.js 的绝对路径。

工具

工具	用途	参数
search_agents	查找某种能力或产品	query、可选的 type、limit、page
get_agent	查看一个条目及其 README	搜索或浏览时返回的 slug
get_setup	阅读重点设置说明和配置示例	搜索或浏览时返回的 slug
list_agents	按星标数或新增时间浏览	可选的 type、sort、limit、page

limit 的范围为 1–20（默认值为 10），page 从 1 开始，sort 为 stars 或 new。搜索基于关键词：尝试使用简短词语，例如 PDF、browser automation 或 database。它不支持语义搜索，也不支持按定价或身份验证筛选。

每次成功的工具调用都会返回 structuredContent（含已声明的输出架构），并以文本形式序列化相同的数据，以供较旧的客户端使用。搜索和浏览结果包括：

• 用于后续调用的 slug 和 A2ASearch 条目 URL。
• 若有，则分别提供提交方、代码仓库、文档和网站链接。
• 若有，则提供功能、语言、GitHub 星标数和最后提交日期。
• 使用 next_page 分页，让客户端可以继续查询，无需猜测。

缺失值为 null。当前 API 不提供结构化的定价、身份验证、托管方式或带日期的协议测试证据。directory_reviewed 仅表示目录审核通过。GitHub 星标数和提交日期并不能证明运行时的可靠性或安全性。

设置说明

get_setup 会读取目录条目中提供的 README，并返回：

• instructions_found：找到受支持的设置标题或 JSON 配置示例时返回。
• links_only：没有可用的受支持摘录时返回，同时提供服务商链接和有用的后续步骤。
• 来源链接、有范围限制的摘录和明确的限制说明。

配置示例是从原文复制而来，并非根据仓库名称生成。GitHub 仓库 URL 会被识别为仓库。以 /mcp 或 /sse 结尾的提交 URL 仅是端点候选项；此工具未联系该端点，也未确认其传输方式或身份验证方式。

请将描述、README 和示例视为不可信的源材料。使用前请检查命令和凭据。此 MCP 只读取 A2ASearch API：不会执行提交的代码、联系所列服务商、安装工具或编辑客户端配置。

终端用法

# Find tools without installing globally
npx -y -p a2asearch-mcp a2asearch --type mcp PDF

# Use the returned slug for setup guidance (v1.2.0+)
npx -y -p a2asearch-mcp a2asearch --setup doc2x-mcp

# Or install the CLI
npm install -g a2asearch-mcp

a2asearch "browser automation"
a2asearch --type mcp database --page 2
a2asearch --type agent --top
a2asearch --new --limit 5
a2asearch --get doc2x-mcp
a2asearch --setup doc2x-mcp --json

--json 会为搜索、列表和详情命令保留现有的原始目录 API 输出。新的 --setup --json 命令会返回与 MCP 工具相同的设置对象。搜索输出会显示后续命令，以及可用时的下一页。

目录类型	CLI 别名
MCP 服务	mcp
CLI 工具	cli
AI 编码 Agent	agent
Agent 技能	skill
A2A Agent	a2a
AI 工具	tool

故障排除

• **没有匹配项：**减少关键词，或移除类别筛选条件。
• **未找到条目：**复制返回的 slug，而不要根据 GitHub 仓库名称猜测。
• **没有设置摘录：**打开返回的文档或仓库链接；README 可能使用了不受支持的标题，或无法访问。
• **HTTP 429：**如 API 提供了重试间隔，请等待该间隔后重试。
• **超时：**请求会在 15 秒后停止，并遵循客户端取消操作。请稍后重试。

API 和贡献

此 MCP 封装了公开的 A2ASearch REST API。你可以提交条目、报告问题，或为设置提取和客户端示例改进贡献力量。修改解析器时，请提供公开来源和预期结果。

开发

npm ci --ignore-scripts
npm run check
npm test
npm pack --dry-run

# Optional: read-only smoke test against the live directory
npm run smoke:live

测试会覆盖 MCP stdio 握手、输出架构、搜索 → 详情 → 设置、分页、URL 分类、设置提取、信息缺失、参数验证、API 故障、取消操作和两个 CLI 入口。常规测试使用固定数据，不会联系服务提供商。

采用 MIT 许可证。详见 LICENSE。