eve-online-mcp

EVE Online Market MCP Server

このMCPサーバーは、EVE Onlineのマーケットデータにアクセスするためのインターフェースを提供します。ESI（EVE Swagger Interface）APIを使用して、リアルタイムの市場データを取得できます。

認証とレート制限

このサーバーは現在、パブリックなマーケットデータのみを取得するため、ESI認証は必要ありません。ただし、以下の制限と仕様があります：

1. レート制限
   • ESIには1分あたりのエラー制限があります
   • サーバーは自動的にレート制限を監視し、制限に達した場合はエラーを返します
   • ヘッダーx-esi-error-limit-remainとx-esi-error-limit-resetで制限状態を確認できます
2. ユーザーエージェント
   • ESIの推奨事項に従い、適切なユーザーエージェントを設定しています
   • 形式: eve-online-mcp/1.0 (github.com/your-username/eve-online-mcp)
3. エラーハンドリング
   • APIエラーは適切にキャプチャされ、わかりやすいメッセージとして返されます
   • ESIからのエラー詳細情報も含まれます

機能

サーバーは以下の3つの主要な機能を提供します：

1. 市場価格の取得 (get-market-prices)
   • EVE Online内のすべてのアイテムの調整価格と平均価格を取得
   • 返り値には type_id、adjusted_price、average_price が含まれます
2. 市場注文の取得 (get-market-orders)
   • 特定のリージョンの市場注文を取得
   • オプションで特定のアイテムタイプやオーダータイプ（買い/売り）でフィルタリング可能
   • 各注文には価格、数量、場所などの情報が含まれます
3. 市場履歴の取得 (get-market-history)
   • 特定のリージョンの特定のアイテムの市場履歴を取得
   • 日ごとの最高価格、最低価格、平均価格、取引量などを取得可能
4. グループ化された市場データの取得 (get-market-groups)
   • 特定のリージョンと特定のアイテムタイプのグループ化された市場データを取得
   • 買い注文と売り注文それぞれの統計情報（平均価格、最高/最低価格、取引量など）を提供
5. 構造体の市場注文取得 (get-structure-orders)
   • 特定の構造体（ステーション、シタデルなど）の全市場注文を取得
   • ページネーション対応で大量のデータを効率的に取得可能
6. 地域の取引所統計取得 (get-market-stats)
   • 特定の地域の市場統計情報を取得
   • 取引量、価格トレンド、市場活性度などの指標を提供
7. 構造体の特定アイテム注文取得 (get-structure-type-orders)
   • 特定の構造体における特定のアイテムタイプの全市場注文を取得
   • より詳細な市場分析が可能

セットアップ

Installing via Smithery

To install eve-online-mcp for Claude Desktop automatically via Smithery:

1. 依存パッケージのインストール：
   npm install
2. プロジェクトのビルド：
   npm run build
3. サーバーの起動：
   npm start

VS Code統合

このプロジェクトはVS Code用の設定が含まれています：

• .vscode/settings.json: MCPサーバーの設定
• .vscode/tasks.json: ビルドと実行用のタスク

以下のタスクが利用可能です：

• "Build EVE Online Market MCP Server": プロジェクトをビルド
• "Run EVE Online Market MCP Server": MCPサーバーを起動

使用例

1. 市場価格の取得：

2. 市場注文の取得：

3. 市場履歴の取得：

4. グループ化された市場データの取得：

5. 構造体の市場注文取得：

6. 地域の取引所統計取得：

7. 構造体の特定アイテム注文取得：

認証設定

EVE Online SSO設定

1. EVE Online Developers Portalでアプリケーションを登録
2. 以下のスコープを要求:
   • esi-markets.structure_markets.v1
   • esi-markets.read_character_orders.v1
3. 取得したクライアントIDとシークレットを.envファイルに設定:
   cp .env.example .env # .envファイルを編集して認証情報を設定

認証フロー

1. 認証URLの取得:

2. 認証コードの交換:

3. トークンの更新:

構造体アクセス

認証が必要な構造体のマーケットデータにアクセスする場合：

1. 適切なスコープを持つトークンを取得
2. makeESIRequestの呼び出し時にトークンを指定:

注意事項

1. 構造体関連のエンドポイント
   • 構造体関連のエンドポイントにアクセスするには、適切な権限を持つESIトークンが必要です
   • アクセス権のない構造体のデータは取得できません
2. ページネーション
   • 大量のデータを返すエンドポイントはページネーションを使用します
   • pageパラメータで特定のページを指定できます（1から開始）
3. キャッシュ
   • ESIのレスポンスはサーバー側でキャッシュされます
   • キャッシュ期間はエンドポイントによって異なります
   • キャッシュ情報はレスポンスヘッダーで確認できます