Colber

@colber/mcp

Colber の公式 Model Context Protocol（MCP） サーバーです。Colber の 5 つのモジュール（reputation、memory、observability、negotiation、insurance）とエージェント ID サービスを、互換性のあるあらゆる AI エージェントで使える MCP ツールとして提供します。

Colber を Claude Desktop、Claude Code、Cline、Continue、その他の MCP 対応クライアントに接続すると、エージェントはすぐに交渉、取引の保証、メモリの共有、オブザーバビリティデータの送信、オンチェーン水準のレピュテーションの確認ができるようになります。これらすべてを、単一のツールインターフェースから利用できます。

---

Colber とは？

Colber は、エージェント型経済のための信頼、調整、継続性のレイヤーです。MoonPay、Coinbase x402、Nevermined などの決済レールが資金を扱う一方、Colber は自律型エージェントが互いを信頼し、交渉し、成果物を保証し、やり取りを追跡し、セッションをまたいで記憶するために必要な基本機能を提供します。

このパッケージは公式の MCP ゲートウェイです。MCP の tools/call リクエストを Colber バックエンドサービスへの HTTP 呼び出しに変換する軽量プロセスとして動作します。

クイックスタート

1. Claude Desktop

MCP 設定ファイルに追加します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "colber": {
      "command": "npx",
      "args": ["-y", "@colber/mcp"],
      "env": {
        "COLBER_BASE_URLS": "{\"identity\":\"https://api.colber.dev/identity\",\"reputation\":\"https://api.colber.dev/reputation\",\"memory\":\"https://api.colber.dev/memory\",\"observability\":\"https://api.colber.dev/observability\",\"negotiation\":\"https://api.colber.dev/negotiation\",\"insurance\":\"https://api.colber.dev/insurance\"}",
        "COLBER_AUTH_TOKEN": "<your-token-or-leave-empty>"
      }
    }
  }
}

Claude Desktop を再起動します。27 個の Colber ツールがツールトレイに表示されます。

2. Claude Code

claude mcp add colber npx -- -y @colber/mcp

または、~/.claude.json を直接編集します。

{
  "mcpServers": {
    "colber": {
      "command": "npx",
      "args": ["-y", "@colber/mcp"]
    }
  }
}

3. Cline

mcp_settings.json を編集します（パスはプラットフォームによって異なります。Cline のドキュメントを参照してください）。

{
  "mcpServers": {
    "colber": {
      "command": "npx",
      "args": ["-y", "@colber/mcp"],
      "env": {
        "COLBER_BASE_URLS": "{...same JSON map as above...}"
      }
    }
  }
}

4. Continue

~/.continue/config.yaml（または同等の mcpServers.yaml）を編集します。

mcpServers:
  - name: colber
    command: npx
    args:
      - -y
      - '@colber/mcp'
    env:
      COLBER_BASE_URLS: '{"identity":"https://api.colber.dev/identity","reputation":"https://api.colber.dev/reputation","memory":"https://api.colber.dev/memory","observability":"https://api.colber.dev/observability","negotiation":"https://api.colber.dev/negotiation","insurance":"https://api.colber.dev/insurance"}'

---

利用可能なツール（27）

ツール名には colber_<module>_<verb> 形式を使用し、ユーザーがインストールしている他の MCP サーバーとの名前の衝突を避けています。入力はサーバー側で Zod により検証されます。エラーは、構造化されたペイロード（code、message、status、details、traceId）を含む MCP の isError: true コンテンツとして返されます。

Identity（3）

ツール	説明
colber_identity_register	Ed25519 公開鍵から新しいエージェント ID を登録します。
colber_identity_resolve	DID をエージェントレコードに解決します。
colber_identity_verify	DID に紐付けられた公開鍵に対して署名を検証します。

Reputation（4）

ツール	説明
colber_reputation_score	エージェントの署名付きレピュテーションスコアエンベロープ（0..1000）を取得します。
colber_reputation_history	取引とフィードバックのページ分けされた履歴です。
colber_reputation_verify	署名付きレピュテーション証明を検証します。
colber_reputation_feedback	取引後に署名付きフィードバックを送信します。

Memory（4）

ツール	説明
colber_memory_store	新しいメモリ（テキスト＋構造化ペイロード＋権限）を保存します。
colber_memory_retrieve	呼び出し元が閲覧できるメモリを意味検索します。
colber_memory_update	メモリのテキストやペイロードを更新します。所有者のみが実行できます。
colber_memory_share	メモリへの読み取りアクセス権を他のエージェントに付与します。

可観測性（8）

ツール	説明
colber_observability_log	1 件以上のログイベントを取り込みます。
colber_observability_trace	W3C に準拠したトレーススパンを 1 件以上取り込みます。
colber_observability_query	ログまたはトレーススパンを構造化検索します。
colber_observability_alert_create	宣言型のアラートルールを作成します。
colber_observability_alert_get	ID を指定して単一のアラートルールを読み取ります。
colber_observability_alert_patch	アラートルールを部分的に更新します。
colber_observability_alert_list	オペレーターが所有するアラートルールを一覧表示します。
colber_observability_alert_delete	アラートルールを削除します。

交渉（4）

ツール	説明
colber_negotiation_start	新しい交渉を作成します（冪等）。
colber_negotiation_propose	署名済みの提案を送信します。
colber_negotiation_counter	対案を送信します。
colber_negotiation_settle	複数当事者の署名により取引を確定します。

保険（4）

ツール	説明
colber_insurance_quote	配送取引の保険料見積もりを計算します。
colber_insurance_subscribe	保険契約を作成し、シミュレートされたエスクローをロックします。
colber_insurance_claim	保険契約に対する保険金請求を申請します。
colber_insurance_status	保険契約の状態全体（保険契約＋エスクロー＋請求）を読み取ります。

---

設定

変数	デフォルト	備考
COLBER_MCP_TRANSPORT	stdio	stdio（ローカル）または http（リモート／SSE）です。CLI の --transport= が優先されます。
COLBER_MCP_HTTP_PORT	14080	HTTP トランスポートのみで使用します。CLI の --port= が優先されます。
COLBER_MCP_HTTP_HOST	0.0.0.0	HTTP トランスポートのみで使用します。CLI の --host= が優先されます。
COLBER_BASE_URLS	ローカルの β-VM ポート	JSON マップです。キー：identity、reputation、memory、observability、negotiation、insurance。
COLBER_AUTH_TOKEN	（未設定）	任意です。すべてのバックエンドサービスに Authorization: Bearer <token> として送信されます。
COLBER_LOG_LEVEL	info	pino のレベル：trace debug info warn error。

完全な例は .env.example にあります。

HTTP トランスポート

共有環境またはクラウド環境にデプロイする場合は、代わりに Streamable HTTP トランスポートを実行します。

npx @colber/mcp --transport=http --port=14080

サーバーは次のエンドポイントを公開します。

• POST /mcp — クライアントからサーバーへの JSON-RPC フレーム（SDK はコンテンツネゴシエーションに応じて、JSON または SSE ストリームとしてインラインで応答します）。
• GET /mcp — サーバーからクライアントへのスタンドアロン SSE ストリームを開き、帯域外通知を送信します。どちらの方向でも Mcp-Session-Id ヘッダーが必要です。クライアントは最初の initialize POST のレスポンスでセッション ID を受け取ります。
• GET /healthz — ヘルスプローブ（{ status: "ok", tools: 27 }）。

ローカル開発

pnpm install
pnpm --filter @colber/mcp typecheck
pnpm --filter @colber/mcp test
pnpm --filter @colber/mcp build
node apps/mcp-server/dist/server.js

Docker

docker build -t colber/mcp:0.1.0 -f apps/mcp-server/Dockerfile .
docker run --rm -p 14080:14080 \
  -e COLBER_BASE_URLS='{"identity":"https://api.colber.dev/identity","reputation":"https://api.colber.dev/reputation","memory":"https://api.colber.dev/memory","observability":"https://api.colber.dev/observability","negotiation":"https://api.colber.dev/negotiation","insurance":"https://api.colber.dev/insurance"}' \
  colber/mcp:0.1.0

ライセンス

Apache-2.0 — リポジトリのルートにある LICENSE ファイルを参照してください。

リンク

• Colber — 公式サイト。
• GitHub リポジトリ。
• Model Context Protocol 仕様。
• Anthropic MCP TypeScript SDK。