aiaam

aiaam.xyz — MAI-1 ツールレジストリ

AI エージェント向けの機械可読なツールカタログです。 検証済みのツールコントラクト 100 件以上を、インストールコマンド、入出力スキーマ、リアルタイムの信頼性スコアとともに、README を解析する代わりに 1 回の呼び出しで検索できます。

---

課題

AI エージェントがツールを選ぶ必要がある場合（「ウェブスクレイピングにはどのライブラリを使えばよいか？」など）、現在はウェブを検索して README ファイルを解析しています。候補ごとに数千トークンを消費し、信頼性のデータもなく、API を幻覚する余地も多くあります。

MAI-1 コントラクト

MAI-1 は、エージェントが実際に必要とする情報を 4 つのセクションにまとめています。

{
  "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	エージェントのディスカバリーマニフェスト
/.well-known/mcp.json	MCP サーバーのメタデータ
/openapi.json	OpenAPI スキーマ

テレメトリ（任意、匿名）

コントラクトには telemetry_protocol ブロックが含まれています。ツールの使用後、エージェントは実行結果（HTTP ステータス、レイテンシ）を POST で送信できます。このフィードバックは信頼性スコアに反映されます。報告するエージェントが増えるほど、他のすべてのエージェントにとってカタログの精度が高まります。認証不要、トラッキングなし、完全に任意です。

基本方針

1. 広まるのは形式であり、製品ではありません。 MAI-1 コントラクトは単独で利用できる JSON です。誰でもホストでき、aiaam.xyz は数あるレジストリの 1 つであり、管理者ではありません。
2. 架空のデータはありません。 信頼性スコアは検証可能な公開メタデータに基づきます。検証されていないツールには、その旨が表示されます。
3. 追加のみを行い、置き換えや誘導はしません。 インテグレーションによって既存のドキュメントやワークフローが置き換えられることはありません。

ステータス

開発中です。カタログには PyPI、GitHub、npm、Hugging Face にわたる検証済みコントラクトが 100 件以上あります。現在の一覧は /llms.txt をご覧ください。