DexScreener MCP Server

DexScreener MCP サーバー

DexScreener API にアクセスするための MCP サーバー実装です。複数のブロックチェーンにわたる DEX ペアデータ、トークン情報、市場統計にリアルタイムでアクセスできます。

ワンラインインストール（Claude Desktop に自動で追加）：

curl -L https://raw.githubusercontent.com/opensvm/dexscreener-mcp-server/main/install.sh | bash

機能

• レート制限付き API アクセス（DexScreener のレート制限を遵守）
• 包括的なエラー処理
• 型安全なインターフェース
• DexScreener API の全エンドポイントに対応
• 統合テスト

インストール

手動インストール：

npm install
npm run build
npm run setup

テスト

npm test

使用方法

利用可能なツール

1. get_latest_token_profiles

   • 最新のトークンプロフィールを取得します
   • パラメーターは不要です

   const result = await mcpClient.callTool('dexscreener', 'get_latest_token_profiles');
   

2. get_latest_boosted_tokens

   • 最新のブースト済みトークンを取得します
   • パラメーターは不要です

   const result = await mcpClient.callTool('dexscreener', 'get_latest_boosted_tokens');
   

3. get_top_boosted_tokens

   • 最もアクティブなブーストを受けているトークンを取得します
   • パラメーターは不要です

   const result = await mcpClient.callTool('dexscreener', 'get_top_boosted_tokens');
   

4. get_token_orders

   • 特定のトークンに対して支払われた注文を確認します

   const result = await mcpClient.callTool('dexscreener', 'get_token_orders', {
     chainId: 'solana',
     tokenAddress: 'So11111111111111111111111111111111111111112'
   });
   

5. get_pairs_by_chain_and_address

   • チェーンとペアアドレスを指定して、1つまたは複数のペアを取得します

   const result = await mcpClient.callTool('dexscreener', 'get_pairs_by_chain_and_address', {
     chainId: 'solana',
     pairId: 'HxFLKUAmAMLz1jtT3hbvCMELwH5H9tpM2QugP8sKyfhc'
   });
   

6. get_pairs_by_token_addresses

   • トークンアドレスを指定して、1つまたは複数のペアを取得します（最大30件）

   const result = await mcpClient.callTool('dexscreener', 'get_pairs_by_token_addresses', {
     tokenAddresses: 'So11111111111111111111111111111111111111112'
   });
   

7. search_pairs

   • クエリに一致するペアを検索します

   const result = await mcpClient.callTool('dexscreener', 'search_pairs', {
     query: 'SOL'
   });
   

レート制限

このサーバーは、DexScreener API の制限に準拠するため、レート制限を実装しています。

• トークンプロフィール／ブーストエンドポイント：1分あたり60リクエスト
• DEX／ペアエンドポイント：1分あたり300リクエスト

エラー処理

このサーバーは、さまざまなエラー状況に対応します。

• レート制限超過
• 無効なパラメーター
• ネットワークエラー
• API エラー

エラーは、適切なエラーコードとメッセージを含む標準形式で返されます。

API ドキュメント

詳しい API ドキュメントについては、docs/api-reference.md を参照してください。

開発

プロジェクト構成

.
├── src/
│   ├── types/           # TypeScript interfaces and types
│   ├── services/        # API service implementations
│   ├── tests/           # Integration tests
│   └── index.ts         # Main server implementation
├── scripts/            # Setup and utility scripts
├── docs/              # Documentation
└── README.md          # This file

新機能の追加

1. src/types/ に型を定義します
2. src/services/ にサービスメソッドを実装します
3. src/index.ts にツールハンドラーを追加します
4. ドキュメントを更新します
5. テストを追加します

ライセンス

MIT