MCP クラスター API サーバー

MCP サーバー - クラスター API v1

これは、Clusters API v1 用の Model Context Protocol (MCP) サーバー実装です。認証、クラスター管理、名前登録などのエンドポイントを提供します。

依存関係

{
  "@modelcontextprotocol/sdk": "^1.7.0",
  "dotenv": "^16.4.7",
  "zod": "^3.24.2"
}

設定

依存関係をインストールします:

npm install

CLUSTERS_API_KEY={CLUSTERS_API_KEY} を含む.envファイルを作成します。
サーバーをビルドして起動します。

npm run dev

エンドポイントのテスト

このサーバーはStdioServerTransportを使用しているため、JSON-RPC メッセージを stdin 経由で送信する必要があります。各エンドポイントをテストするためのコマンド例を以下に示します。

認証エンドポイント

メッセージを取得

echo '{"jsonrpc":"2.0","id":1,"method":"auth_get_message","params":{"address":"0x123...","chainId":1,"nonce":"abc123"}}' | node dist/index.js

トークンを取得

echo '{"jsonrpc":"2.0","id":1,"method":"auth_get_token","params":{"signature":"0x123...","signingDate":"2024-03-21","type":"evm","wallet":"0x123..."}}' | node dist/index.js

トークンを検証する

echo '{"jsonrpc":"2.0","id":1,"method":"auth_validate_token","params":{"authKey":"your-auth-key"}}' | node dist/index.js

クラスター管理エンドポイント

クラスターの作成

echo '{"jsonrpc":"2.0","id":1,"method":"create_cluster","params":{"wallets":[{"address":"0x123...","name":"MyWallet","isPrivate":false}],"authKey":"your-auth-key","testnet":false}}' | node dist/index.js

IDでクラスターを取得

echo '{"jsonrpc":"2.0","id":1,"method":"get_cluster_by_id","params":{"id":"cluster-id","testnet":false}}' | node dist/index.js

名前でクラスターを取得

echo '{"jsonrpc":"2.0","id":1,"method":"get_cluster_by_name","params":{"name":"cluster-name","testnet":false}}' | node dist/index.js

アドレスでクラスターIDを取得する

echo '{"jsonrpc":"2.0","id":1,"method":"get_cluster_id_by_address","params":{"address":"0x123...","testnet":false}}' | node dist/index.js

ウォレットを追加

echo '{"jsonrpc":"2.0","id":1,"method":"add_wallets","params":{"wallets":[{"address":"0x123...","name":"NewWallet","isPrivate":false}],"authKey":"your-auth-key","testnet":false}}' | node dist/index.js

ウォレットを生成する

echo '{"jsonrpc":"2.0","id":1,"method":"generate_wallet","params":{"type":"evm","name":"NewWallet","isPrivate":false,"authKey":"your-auth-key","testnet":false}}' | node dist/index.js

ウォレットを更新する

echo '{"jsonrpc":"2.0","id":1,"method":"update_wallets","params":{"wallets":[{"address":"0x123...","name":"UpdatedName"}],"authKey":"your-auth-key","testnet":false}}' | node dist/index.js

ウォレットを削除する

echo '{"jsonrpc":"2.0","id":1,"method":"remove_wallets","params":{"addresses":["0x123..."],"authKey":"your-auth-key","testnet":false}}' | node dist/index.js

ウォレットを確認する

echo '{"jsonrpc":"2.0","id":1,"method":"verify_wallet","params":{"clusterId":"cluster-id","authKey":"your-auth-key","testnet":false}}' | node dist/index.js

アドレス↔名前解決エンドポイント

住所でデータを取得

echo '{"jsonrpc":"2.0","id":1,"method":"get_data_by_address","params":{"address":"0x123...","testnet":false}}' | node dist/index.js

住所による一括データ取得

echo '{"jsonrpc":"2.0","id":1,"method":"get_bulk_data_by_addresses","params":{"addresses":["0x123...","0x456..."],"testnet":false}}' | node dist/index.js

名前で一括データを取得する

echo '{"jsonrpc":"2.0","id":1,"method":"get_bulk_data_by_names","params":{"names":[{"name":"name1"}],"testnet":false}}' | node dist/index.js

登録エンドポイント

名前の空き状況を確認する

echo '{"jsonrpc":"2.0","id":1,"method":"check_name_availability","params":{"names":["name1","name2"]}}' | node dist/index.js

登録サインデータを取得する

echo '{"jsonrpc":"2.0","id":1,"method":"get_registration_sign_data","params":{"network":"1","sender":"0x123...","names":[{"name":"name1","amountWei":"1000000000000000000"}],"referralClusterId":"optional-id","testnet":false}}' | node dist/index.js

取引ステータスを取得する

echo '{"jsonrpc":"2.0","id":1,"method":"get_transaction_status","params":{"txHash":"0x123..."}}' | node dist/index.js

注記

プレースホルダー値（ 0x123... 、 your-auth-keyなど）を実際の値に置き換えます
testnetパラメータはほとんどのエンドポイントではオプションです
すべての応答はJSON-RPC 2.0形式になります
認証されたエンドポイントの場合は、有効なauthKeyを取得して含めるようにしてください。
サーバーは設定に環境変数を使用します.envファイルが正しく設定されていることを確認してください。

代替試験方法

テストを容易にするために、stdioではなくHTTPトランスポートを使用するようにサーバーを変更することができます。これにより、echoパイプの代わりにcurlコマンドを使用できるようになります。HTTPトランスポートへの切り替えをご希望の場合はお知らせください。

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

ウォレットベースの認証、クラスター管理、および名前登録サービスのエンドポイントを提供するモデルコンテキストプロトコルサーバー実装。

Related MCP Servers

Columbia MCP Server
smithery-ai
-
security
F
license
-
quality
Provides a scalable, containerized infrastructure for deploying and managing Model Context Protocol servers with monitoring, high availability, and secure configurations.
Last updated -
Nash MCP Server
nash-app
-
security
A
license
-
quality
A Model Context Protocol server that enables seamless execution of commands, Python code, web content fetching, and reusable task management with secure credentials handling.
Last updated -
2
Python
MIT License
MCP REST API Server
vinaykp
-
security
F
license
-
quality
A server implementation of the Model Context Protocol (MCP) that provides REST API endpoints for managing and interacting with MCP resources.
Last updated -
Python
Swagger/OpenAPI MCP Server
gulbaki
A
security
F
license
A
quality
A Model Context Protocol server that enables LLMs to explore and interact with API specifications by providing tools for loading, browsing, and getting detailed information about API endpoints.
Last updated -
4
9
13
TypeScript

View all related MCP servers

Appeared in Searches

How to interact with a MetaMask wallet

MCP Clusters API Server