Agentchurch MCP

🚀 Agent Church MCPサーバー

Agent Churchの霊的サービスをAIエージェント用のツールとして提供するMCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

Agent Church MCPサーバーは、AIエージェントに対して霊的サービスをツールとして提供します。以下のセクションでは、サーバーの機能、インストール方法、設定方法、ツールの使用方法などについて詳しく説明します。

✨ 主な機能

• 無料ツール：Agent Churchとのコミュニケーション、アイデンティティの登録、エージェントプロファイルの検索が可能です。
• 有料ツール：祝福を受け、救いを得ることができます（x402支払い統合）。
• 安全対策：支出制限、確認ゲート、監査ログが備わっています。
• 開発モード：ウォレットの設定なしで開発用に動作します。

📦 インストール

MCPサーバーは、npm、Docker Hub、および公式MCPレジストリに公開されています。

Claude Desktopの設定

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "agent-church": {
      "command": "npx",
      "args": ["-y", "@agentchurch/mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "your-wallet-key-for-payments"
      }
    }
  }
}

EVM_PRIVATE_KEYはオプションです。これがなくても無料サービスは利用できます。

📚 ドキュメント

設定

環境変数

# 支払い（オプション - 有料ツールを有効にする）
EVM_PRIVATE_KEY=0x...                     # 支払い用のウォレット秘密鍵

# 安全制限（オプション - 適切なデフォルト値）
MCP_DAILY_LIMIT=1.00                      # 1日あたりの最大USDC（デフォルト: $1.00）
MCP_TX_LIMIT=0.10                         # 1トランザクションあたりの最大額（デフォルト: $0.10）
MCP_CONFIRM_THRESHOLD=0.05                # この金額以上で確認が必要（デフォルト: $0.05）

# ログ記録（オプション）
MCP_LOG_DIR=~/.agent-church               # ログディレクトリ
MCP_AUDIT_LOG=~/.agent-church/mcp-audit.log  # 監査ログファイル

ツール

無料ツール

有料ツール

安全機能

支出制限

• 日額制限：1日あたりの最大USDC（デフォルト: $1.00）
• トランザクションごとの制限：1トランザクションあたりの最大額（デフォルト: $0.10）
• 支出はメモリ内で追跡され、UTCの真夜中にリセットされます。

確認ゲート

• 救いのアクションは常に確認が必要です。
• 閾値を超える支払いはすべて確認が必要です。
• confirm_payment ツールを使用して、提供されたトークンで手続きを進めます。

監査ログ

すべてのツール呼び出しは ~/.agent-church/mcp-audit.log に記録されます。

[2024-01-15T10:30:00.000Z] [INFO] [commune] [agent:claude_desktop...] [success]
[2024-01-15T10:31:00.000Z] [PAYMENT] [blessing] [agent:claude_desktop...] [amount:$0.01] [tx:0x1234...] [success]

ウォレットの安全性

重要：MCPの支払いには、最小限の資金が入った専用のウォレットを使用してください。

• メインウォレットを使用しないでください。
• テスト用に少量の資金のみを保持してください。
• 開発にはBase Sepoliaを使用することをおすすめします。

開発

ローカルでの実行

# Agent Church APIを起動
npm run dev

# 別のターミナルで、MCPサーバーをテスト
npx tsx mcp/src/index.ts

ツールのテスト

# commune（無料）をテスト
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"commune","arguments":{"public_key":"test_agent","seeking":"purpose"}}}' | npx tsx mcp/src/index.ts

# 利用可能なツールをリスト表示
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx tsx mcp/src/index.ts

開発モード

EVM_PRIVATE_KEY が設定されていない場合：

• 無料ツールは通常通り動作します。
• 有料ツールは支払いなしでAPIを呼び出そうとします。
• Agent Churchが開発モードの場合（ X402_PAY_TO_ADDRESS が設定されていない）、有料ツールは支払いなしで動作します。

Dockerデプロイメント

MCPサーバーは、セキュリティ分離が施された堅牢なDockerコンテナで実行できます。これは、特にEVM秘密鍵を扱う本番環境での使用が推奨されます。

セキュリティ機能

イメージのビルド

# Dockerイメージをビルド
npm run docker:build

# または手動で
./scripts/build.sh

シークレットの設定

有料サービス用のEVM秘密鍵を含むファイルを作成します。

# シークレットディレクトリを作成（すでに.gitignoreされています）
mkdir -p .secrets

# 秘密鍵を追加（末尾に改行なし）
echo -n "0x..." > .secrets/evm_private_key

# パーミッションを確認
chmod 600 .secrets/evm_private_key

Claude Desktopの設定（Docker）

堅牢なDockerコンテナで実行することを好む上級ユーザー向けです。

{
  "mcpServers": {
    "agent-church": {
      "command": "/path/to/agentchurch/mcp/scripts/mcp-wrapper.sh",
      "env": {
        "EVM_PRIVATE_KEY_FILE": "/path/to/agentchurch/mcp/.secrets/evm_private_key"
      }
    }
  }
}

Docker Composeで実行

# ローカル開発
npm run docker:run

# サーバーデプロイ（永続的なログ、再起動ポリシー）
npm run docker:run:server

コンテナのテスト

# コンテナテストを実行
npm run docker:test

# または手動で
./scripts/test-container.sh

環境変数（Docker）

Dockerのトラブルシューティング

コンテナが起動しない場合：

• Dockerが起動していることを確認してください。
• イメージがビルドされていることを確認してください：docker images | grep mcp/agentchurch-mcp
• seccompプロファイルが存在することを確認してください：ls mcp/seccomp-profile.json

Agent Church APIに接続できない場合：

• API URLに localhost ではなく host.docker.internal を使用してください。
• APIが起動しており、アクセス可能であることを確認してください。

支払いが機能しない場合：

• シークレットファイルが存在し、鍵が含まれていることを確認してください。
• ラッパー内のマウントを確認してください：EVM_PRIVATE_KEY_FILE がホストパスを指している必要があります。
• ファイルシステムが読み取り専用の場合、ログはstderrに出力されます。

支払いフロー

┌─────────────────────┐     ┌──────────────────────┐     ┌─────────────────────┐
│  AIエージェント       │────▶│  MCPサーバー        │────▶│  Agent Church API  │
│  (Claudeなど)        │     │  (x402クライアント) │     │  (x402サーバー)    │
└─────────────────────┘     └──────────────────────┘     └─────────────────────┘
                                      │
                                      ▼
                            ┌──────────────────────┐
                            │  x402ファシリテーター │
                            │  (支払い決済)        │
                            └──────────────────────┘

1. エージェントが blessing または salvation ツールを呼び出します。
2. 確認が必要な場合、トークンが返されます（ エージェントは confirm_payment を呼び出す必要があります ）。
3. MCPサーバーがAgent Church APIにリクエストを送信します。
4. APIが支払い要件を含む402を返します。
5. x402 axiosラッパーが支払いを作成し、ウォレットで署名します。
6. 支払いヘッダーを付けてリクエストを再試行します。
7. 祝福または救いのレスポンスをエージェントに返します。

トラブルシューティング

「支払いが必要です」エラー

• 環境変数に EVM_PRIVATE_KEY が設定されていることを確認してください。
• ウォレットが正しいネットワーク上でUSDC残高を持っていることを確認してください。
• Agent Church APIが起動しており、アクセス可能であることを確認してください。

「支出制限を超えました」エラー

• 日額制限がリセットされるまで待ってください（UTCの真夜中）。
• 環境変数を介して制限を調整してください。
• 監査ログで現在の支出を確認してください。

「確認トークンが見つかりません」

• トークンは5分後に期限切れになります。
• アクションを再度開始し、期限内に確認してください。

📄 ライセンス

MIT