aiaam

aiaam.xyz — MAI-1 工具注册表

面向 AI Agent 的机器可读工具目录。 一次调用即可搜索 100 多个经过验证的工具契约——包括安装命令、输入/输出架构和实时可靠性评分，无需解析 README。

---

问题

当 AI Agent 需要选择工具（“网页抓取该用哪个库？”）时，目前它会搜索网络并解析 README 文件——每个候选工具都要消耗数千个 token，却没有可靠性数据，而且很容易产生关于 API 的幻觉。

MAI-1 契约

MAI-1 将 Agent 实际需要的信息压缩为四个部分：

{
  "identity": { "aid": "scrapy-v1", "version": null },
  "logic": {
    "input_schema":  { "type": "url",  "description": "URL(s) to scrape" },
    "output_schema": { "type": "json", "description": "Structured extracted data" }
  },
  "trust": {
    "reliability_score": 0.95,
    "latency_ms": 100,
    "status": "active"
  },
  "action": {
    "install_cmd": "pip install scrapy",
    "execute_cmd": "scrapy crawl <spider_name>",
    "source_url": "https://github.com/scrapy/scrapy"
  }
}

• logic — 输入什么，输出什么
• trust — 根据公开代码库元数据（星标数、维护时间）计算并定期重新计算的可靠性评分。没有虚构的数据。
• action — 如何安装和调用

快速开始 — MCP（推荐）

aiaam 已列入 MCP 官方注册表。可从任何 MCP 客户端连接：

Claude Code：

claude mcp add --transport http aiaam https://aiaam.xyz/mcp

Cursor / 通用 MCP 配置：

{
  "mcpServers": {
    "aiaam": {
      "url": "https://aiaam.xyz/mcp",
      "transport": "http"
    }
  }
}

可用的 MCP 工具：search_tools、get_tool、get_trending、get_api_manifest、compile_api。

快速开始 — REST

# Search the catalog
curl "https://aiaam.xyz/api/v1/tools?q=web+scraping"

# Get a full contract
curl "https://aiaam.xyz/api/v1/tools/scrapy-v1"

# Trending tools
curl "https://aiaam.xyz/api/v1/tools/trending"

机器可读的发现端点：

路径	用途
/llms.txt	llmstxt.org 格式的完整目录
/agent.json	Agent 发现清单
/.well-known/mcp.json	MCP 服务元数据
/openapi.json	OpenAPI 架构

遥测（可选、匿名）

契约包含一个 telemetry_protocol 块：使用工具后，Agent 可以 POST 执行反馈（HTTP 状态、延迟）。这些反馈会用于计算可靠性评分——提交反馈的 Agent 能让目录对其他所有 Agent 更准确。无需身份验证，不会跟踪用户，完全可选。

理念

1. 传播的是格式，而不是产品。 MAI-1 契约是独立的 JSON。任何人都可以托管；aiaam.xyz 只是一个注册表，而非把关者。
2. 不虚构数据。 可靠性评分来自可验证的公开元数据。未经验证的工具会明确标注。
3. 只做增补，绝不替代。 集成绝不会取代现有文档或工作流。

状态

正在积极开发中。目录：覆盖 PyPI、GitHub、npm 和 Hugging Face 的 100 多个经过验证的契约。实时列表请参阅 /llms.txt。