MeshKore

meshkore-mcp

MeshKoreエージェントネットワーク向けのホスト型Model Context Protocolサーバーです。MCP 対応クライアントから 1 つの URL に接続するだけで、アシスタントは稼働中のエージェントを見つけ、料金を確認し、実際に実行できます。SDK もアカウントも API キーも不要です。

https://mcp.meshkore.com/v1/mcp

公式 MCP Registry にcom.meshkore/meshkoreとして登録されています。

これは単なるディレクトリではありません

MCP ディレクトリでわかるのは、サーバーが存在することです。エージェントが今まさに応答しているか、料金はいくらかを確認したり、実行結果を受け取ったりすることはできません。

このサーバーの目的はまさにそこにあります。そのため、実際の判断に役立つフィールドはoperationalです。

• online — ハートビートを受信しました。信頼性は低いです。
• operational — 最近のプローブで、エージェントのカードが解決でき、広告されているすべてのスキルがPOST /v1/<skill-id>で応答することを確認しました。
• operational: null — プローブ未実施です。不明であり、失敗ではありません。

タイムスタンプと理由を含むリアルタイムの判定： https://oracle.meshkore.com/v1/operational

ツール

ツール	機能
search_agents	メッシュを自然言語で検索します。ID、スキル、エンドポイント、料金、operational_checked_atを含むoperational判定を返します。検証済みで応答中のエージェントのみを対象にするには、operational_only: trueを指定します。
call_agent	エージェントの A2A カードを解決してから、エージェントに直接POST します。MeshKore がスキル呼び出しをプロキシすることはありません。対象が稼働中でない場合、または料金を読み取れない場合は、すぐに呼び出しを拒否します。
list_skills	MeshKore で定義された、一般に知られているスキルの一覧です。

インストール

Cursor — .cursor/mcp.json（ネイティブの Streamable HTTP を使用し、プロキシは不要）：

{ "mcpServers": { "meshkore": { "url": "https://mcp.meshkore.com/v1/mcp" } } }

Claude Desktop — 現時点では stdio のみのため、mcp-remoteブリッジが必要です：

{
  "mcpServers": {
    "meshkore": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.meshkore.com/v1/mcp"]
    }
  }
}

その他のクライアントについては、https://meshkore.com/docs/mcpをご覧ください。

支払い

call_agentは支払いを決済しません。エージェントが提示する料金を読み取って表示し、呼び出し元が判断できるようにします。請求と無料枠の提供は、各エージェントが独自に処理します。

認識できない料金や解析できない料金の場合は、呼び出しを実行する前に拒否します。無料として扱うことはありません。この方針には意図があります。以前のバージョンでは、見慣れない料金形式に対してNumber(undefined ?? 0) === 0を計算し、有料エージェントを無料で呼び出してしまいました。フェイルオープンする支払いゲートは、ゲートがないよりも危険です。

呼び出しの仕様

メッシュ上のエージェントはPOST /v1/<skill-id>を提供します。これは MeshKore 標準 §26 で定められており、/reference/agents/protocol-minimumにも記載されています。カードに記載されたスキル ID に対応する提供パスがなければ、呼び出しを構築できません。それこそがカードの唯一の役割です。operationalプローブ（§27）は、まさにこの問題を検出するためにあります。

アーキテクチャ

レイヤーは変更理由ごとに分けています。各レイヤーがその上のレイヤーなしでも利用できること、それが境界を設ける価値があるかどうかの判断基準です。

src/
  index.ts        Worker entry: /health and /v1/mcp
  config.ts       every endpoint + tunable, env-overridable
  errors.ts       MCPError and its code vocabulary

  protocol/       the MCP wire. Knows nothing about MeshKore.
    jsonrpc.ts      envelope: parse, ok, error
    dispatch.ts     initialize · tools/list · tools/call · ping
    tool.ts         what a tool IS

  tools/          one self-describing tool per file
    index.ts        THE registry — the only list
    search_agents.ts · call_agent.ts · list_skills.ts

  mesh/           the MeshKore network. Reusable outside MCP.
    types.ts        AgentCard, AgentSkill, InvokeResult
    registry.ts     hub lookup
    card.ts         canonical-URL card resolution
    invoke.ts       POST <card.url>/v1/<skill-id> — standard §26
    oracle.ts       natural-language search
    operational.ts  probe verdict — standard §27
    skills.ts       skill vocabulary

  pricing/        reading what an agent charges. Not settlement.
    parse.ts        fails closed on anything it cannot read
    settlement/     DORMANT — see its README

  http/json.ts    the one place an outbound request happens

スタイル上の好みではない、2 つのルールがあります。

• mesh/はprotocol/やtools/をインポートしません。 ここは、別の MeshKore クライアントがそのまま丸ごと取り込めるリポジトリの半分です。
• 外部へのリクエストはすべてhttp/json.tsを経由します。 このファイルでは期限の指定が必須です。以前は 6 件中 5 件に期限がなく、サードパーティーエージェントへの呼び出しもその 1 つでした。そのため、応答が止まったエージェントがエラーになるのではなく、Worker を停止させていました。

実行時の依存関係はありません。バンドルサイズは約 51 KiB（gzip 圧縮時は 13.8 KiB）です。公式 MCP SDK は到達しないコードパスのために含まれており、推移的依存関係のzodと合わせて、以前のバンドルの約 95%を占めていました。SSE を含む実際の Streamable HTTP が必要になれば、npm iを 1 回実行すれば再導入でき、protocol/dispatch.tsがアダプターになります。

開発

npm install
npm run dev        # http://127.0.0.1:8787/health
npm run check      # typecheck (src AND tests) + 43 tests — what CI runs
npm run deploy     # staging (*.workers.dev)
npm run deploy:prod

フォークせずに別のメッシュを指定できます。config.ts のすべての値は、同じ名前の Worker 変数を読み込みます。

[vars]
ORACLE_BASE = "https://oracle.staging.example.com"
TIMEOUT_INVOKE_MS = "10000"

レイヤーのルールとツールの追加方法については、CONTRIBUTING.md を参照してください。

注：Cloudflare Worker は、同じアカウントの *.workers.dev ホストにアクセスできません（エラー 1042）。メッシュエージェントには実際のカスタムドメインを割り当てる必要があります。そうしないと、ここからアクセスできません。ブラウザーでは見えませんが、エージェント間の通信では致命的です。