Eve Online MCP

🚀 EVE Online Market MCP Server

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

🚀 クイックスタート

このMCPサーバーを使うことで、EVE Onlineのマーケットデータにアクセスできます。ESI APIを通じて、リアルタイムの市場データを取得できます。

✨ 主な機能

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

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)：特定の構造体における特定のアイテムタイプの全市場注文を取得でき、より詳細な市場分析が可能です。

📦 インストール

Smitheryを通じたインストール

Smitheryを通じてClaude Desktop用のeve-online-mcpを自動インストールするには、以下のコマンドを実行します：

npx -y @smithery/cli install @kongyo2/eve-online-mcp --client claude

手動インストール

1. 依存パッケージのインストール：

npm install

2. プロジェクトのビルド：

npm run build

3. サーバーの起動：

npm start

💻 使用例

基本的な使用法

市場価格の取得

// すべてのアイテムの価格を取得
const prices = await callTool("get-market-prices");

市場注文の取得

// The Forge（リージョンID: 10000002）のTritanium（タイプID: 34）の注文を取得
const orders = await callTool("get-market-orders", {
  region_id: 10000002,
  type_id: 34,
  order_type: "all"
});

市場履歴の取得

// The ForgeのTritaniumの市場履歴を取得
const history = await callTool("get-market-history", {
  region_id: 10000002,
  type_id: 34
});

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

// The ForgeのTritaniumのグループ化された市場データを取得
const marketGroups = await callTool("get-market-groups", {
  region_id: 10000002,
  type_id: 34
});

構造体の市場注文取得

// 構造体ID: 1234567890 の全市場注文を取得
const structureOrders = await callTool("get-structure-orders", {
  structure_id: 1234567890,
  page: 1
});

地域の取引所統計取得

// The Forgeの市場統計情報を取得
const marketStats = await callTool("get-market-stats", {
  region_id: 10000002
});

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

// 構造体ID: 1234567890 におけるTritaniumの全市場注文を取得
const typeOrders = await callTool("get-structure-type-orders", {
  structure_id: 1234567890,
  type_id: 34,
  page: 1
});

📚 ドキュメント

認証とレート制限

このサーバーは現在、パブリックなマーケットデータのみを取得するため、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からのエラー詳細情報も含まれます。

認証設定

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の取得：

const authUrlResponse = await callTool("get-auth-url", {
  state: "unique-state-string"
});
// ユーザーをauthUrlResponseのURLにリダイレクト

2. 認証コードの交換：

const authResponse = await callTool("authenticate", {
  code: "authorization-code-from-callback"
});
// 返されたトークンを保存

3. トークンの更新：

const refreshResponse = await callTool("refresh-token", {
  refresh_token: "saved-refresh-token"
});
// 新しいトークンで更新

構造体アクセス

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

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

const structureOrders = await callTool("get-structure-orders", {
  structure_id: 1234567890,
  page: 1,
  token: "your-access-token"
});

🔧 技術詳細

注意事項

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

VS Code統合

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

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

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

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