MCP Hats

🚀 Hats Protocol MCP Server

Hats Protocolの操作を管理する包括的なモデルコンテキストプロトコル（MCP）サーバーです。ロール管理、権限チェック、組織構造管理、および複数のブロックチェーンネットワークにまたがる分析をサポートします。

✨ 主な機能

• ハット管理：ハットの作成、ミント、燃焼、転送が可能です。
• ツリー操作：階層的な組織構造を管理します。
• 権限チェック：装着者、スタンディング、および適格性を検証します。
• メタデータ操作：ハットの詳細とプロパティを更新します。
• クエリツール：GraphQLサブグラフを使用してハットを検索およびフィルタリングします。
• 分析：レポートを生成し、アクティビティを追跡します。
• マルチチェーンサポート：すべてのHats Protocolネットワークで動作します。
• 外部署名：ハードウェアウォレットによる署名用のトランザクションを準備します。

📦 インストール

# リポジトリをクローンする
git clone <repository-url>
cd mcp-hats-protocol-server

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

📚 ドキュメント

サポートされているネットワーク

メインネット

• Ethereum
• Polygon
• Arbitrum One
• Optimism
• Base
• Gnosis Chain

テストネット

• Sepolia
• Base Sepolia

設定

環境変数

.env.template を .env にコピーし、以下のように設定します。

# RPCプロバイダーのAPIキー（任意 - 提供されない場合はパブリックエンドポイントを使用）
ALCHEMY_API_KEY=your_key_here
INFURA_API_KEY=your_key_here

# ブロックエクスプローラーのAPIキー（コントラクト検証に必要）
ETHERSCAN_API_KEY=your_key_here
POLYGONSCAN_API_KEY=your_key_here
# ... 他のエクスプローラーキー

APIキー管理

MCPツールを使用してAPIキーを設定することもできます。

{
  "tool": "set-api-key",
  "args": {
    "keyName": "ALCHEMY_API_KEY",
    "value": "your_key_here"
  }
}

使用方法

Claude Codeとの統合

このMCPサーバーを使用する最も簡単な方法は、Claude Codeと統合することです。サーバーをインストールした後、Claudeの設定に追加します。

クイックセットアップ

# サーバーをクローンしてインストールする
git clone https://github.com/your-username/mcp-hats
cd mcp-hats
npm install
npm run build

# Claude Codeに追加する（パフォーマンス向上のためにオプションでAPIキーを指定）
claude mcp add hats-protocol --env ALCHEMY_API_KEY=your_key_here -- node dist/index.js

代替セットアップ方法

オプション1: ローカル開発（ビルド不要）

claude mcp add hats-protocol --env ALCHEMY_API_KEY=your_key_here -- npx tsx src/index.ts

オプション2: グローバルNPMインストール（公開されている場合）

claude mcp add hats-protocol --env ALCHEMY_API_KEY=your_key_here -- npx mcp-hats-protocol

オプション3: チーム/プロジェクト設定

# .mcp.jsonを介したチーム共有用
claude mcp add --scope project hats-protocol --env ALCHEMY_API_KEY=your_key_here -- node dist/index.js

# すべてのプロジェクトでユーザー全体でアクセス可能にする
claude mcp add --scope user hats-protocol --env ALCHEMY_API_KEY=your_key_here -- node dist/index.js

統合の管理

# すべてのMCPサーバーをリストする
claude mcp list

# サーバーの詳細を表示する
claude mcp get hats-protocol

# サーバーを削除する
claude mcp remove hats-protocol

Claude Codeでの環境変数の設定

サーバーを追加する際にAPIキーを設定することができます。

claude mcp add hats-protocol \
  --env ALCHEMY_API_KEY=your_alchemy_key \
  --env ETHERSCAN_API_KEY=your_etherscan_key \
  -- node dist/index.js

手動でのサーバー使用

サーバーを手動で実行する場合は（開発またはスタンドアロン使用のため）、以下のコマンドを使用します。

# 開発モード
npm run dev

# 本番モード
npm start

Claude Codeとの連携

統合後、Claudeとの会話で直接Hats Protocolツールを使用することができます。

例: 誰かが特定のロールを持っているかを確認する

Check if address 0x742C3cF9Af45f91B109a81EfEaf11535ECDe9571 is wearing hat 0x0000000100010000000000000000000000000000000000000000000000000000 on Ethereum

例: 新しい組織を作成する

Help me create a new DAO called "TechCollective" on Base Sepolia with myself (0x742C3cF9Af45f91B109a81EfEaf11535ECDe9571) as the founder

例: 組織構造を分析する

Show me the organizational structure for tree 0x00000001 on Base and visualize it as an ASCII tree

例: ロール割り当てのガイダンスを得る

I need to assign the CTO role to a new team member. Can you guide me through the process and prepare the transaction?

Claudeは自動的に適切なHats Protocolツールを使用し、組み込みのプロンプトとリソースを通じてインテリジェントなガイダンスを提供します。

利用可能なツール

ハット管理

• create-hat - 階層内に新しいハットを作成する
• mint-hat - ハットを装着者に割り当てる
• burn-hat - 装着者からハットを削除する
• transfer-hat - 装着者間でハットを転送する

権限チェック

• check-hat-wearer - アドレスが特定のハットを装着しているかを検証する
• check-hat-standing - 装着者が良好な状態にあるかを確認する

クエリツール

• get-hat-details - ハットの詳細情報を取得する
• query-hats-by-wearer - アドレスが装着しているすべてのハットを取得する
• get-tree-structure - 階層的なツリー構造を取得する

ネットワークツール

• list-networks - サポートされているすべてのネットワークをリストする
• set-api-key - APIキーを設定する

コマンド例

ハットを作成する

{
  "tool": "create-hat",
  "args": {
    "networkName": "ethereum",
    "admin": "0x0000000100000000000000000000000000000000000000000000000000000000",
    "details": "Engineering Team Lead",
    "maxSupply": 1,
    "eligibility": "0x0000000000000000000000000000000000000000",
    "toggle": "0x0000000000000000000000000000000000000000",
    "mutable": true,
    "imageURI": "https://example.com/hat-image.png"
  }
}

ハットの装着者を確認する

{
  "tool": "check-hat-wearer",
  "args": {
    "networkName": "ethereum",
    "wearer": "0x742C3cF9Af45f91B109a81EfEaf11535ECDe9571",
    "hatId": "0x0000000100010000000000000000000000000000000000000000000000000000"
  }
}

開発

プロジェクト構造

src/
├── index.ts           # エントリーポイント
├── server.ts          # MCPサーバーのセットアップ
├── types/             # TypeScript定義
├── utils/             # ユーティリティ関数
├── networks/          # ネットワーク設定
├── clients/           # Hats SDKおよびサブグラフクライアント
├── tools/             # MCPツールの実装
└── resources/         # MCPリソース

test/
├── unit/              # 単体テスト
├── integration/       # 統合テスト
└── e2e/              # エンドツーエンドテスト

テストの実行

# すべてのテストを実行する
npm test

# カバレッジを伴って実行する
npm run test:coverage

# 特定のテストスイートを実行する
npm run test:unit
npm run test:integration
npm run test:e2e

コード品質

# 型チェック
npm run typecheck

# リント
npm run lint

# フォーマット
npm run format

アーキテクチャ

コアコンポーネント

1. MCPサーバー：ツールの登録とリクエストのルーティングを処理します。
2. Hatsクライアント：Hats Protocol SDKのラッパーです。
3. サブグラフクライアント：インデックス化されたデータをクエリするためのGraphQLクライアントです。
4. ネットワークマネージャー：マルチチェーンの設定とRPC管理を行います。
5. ツール実装：特定の操作のための個々のツールです。

データフロー

1. MCPクライアントがツールリクエストをMCPサーバーに送信します。
2. サーバーはZodスキーマを使用して入力を検証します。
3. ツールの実装は適切なクライアントメソッドを呼び出します。
4. クライアントはブロックチェーンまたはサブグラフとやり取りします。
5. レスポンスがフォーマットされ、MCPクライアントに返されます。

リソース

• Hats Protocol Documentation
• SDK Documentation
• Subgraph Documentation
• MCP Specification

コントリビューション

1. 機能ブランチを作成します。
2. 新機能に対するテストを記述します。
3. すべてのテストが通過することを確認します。
4. 詳細な説明付きでプルリクエストを送信します。

📄 ライセンス

MIT