kongyo2/eve-online-mcp
If you are the rightful owner of eve-online-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This MCP server provides an interface to access EVE Online market data using the ESI API for real-time market insights.
EVE Online Market MCP Server
このMCPサーバーは、EVE Onlineのマーケットデータにアクセスするためのインターフェースを提供します。ESI(EVE Swagger Interface)APIを使用して、リアルタイムの市場データを取得できます。
認証とレート制限
このサーバーは現在、パブリックなマーケットデータのみを取得するため、ESI認証は必要ありません。ただし、以下の制限と仕様があります:
-
レート制限
- ESIには1分あたりのエラー制限があります
- サーバーは自動的にレート制限を監視し、制限に達した場合はエラーを返します
- ヘッダー
x-esi-error-limit-remain
とx-esi-error-limit-reset
で制限状態を確認できます
-
ユーザーエージェント
- ESIの推奨事項に従い、適切なユーザーエージェントを設定しています
- 形式:
eve-online-mcp/1.0 (github.com/your-username/eve-online-mcp)
-
エラーハンドリング
- APIエラーは適切にキャプチャされ、わかりやすいメッセージとして返されます
- ESIからのエラー詳細情報も含まれます
機能
サーバーは以下の3つの主要な機能を提供します:
-
市場価格の取得 (
get-market-prices
)- EVE Online内のすべてのアイテムの調整価格と平均価格を取得
- 返り値には
type_id
、adjusted_price
、average_price
が含まれます
-
市場注文の取得 (
get-market-orders
)- 特定のリージョンの市場注文を取得
- オプションで特定のアイテムタイプやオーダータイプ(買い/売り)でフィルタリング可能
- 各注文には価格、数量、場所などの情報が含まれます
-
市場履歴の取得 (
get-market-history
)- 特定のリージョンの特定のアイテムの市場履歴を取得
- 日ごとの最高価格、最低価格、平均価格、取引量などを取得可能
-
グループ化された市場データの取得 (
get-market-groups
)- 特定のリージョンと特定のアイテムタイプのグループ化された市場データを取得
- 買い注文と売り注文それぞれの統計情報(平均価格、最高/最低価格、取引量など)を提供
-
構造体の市場注文取得 (
get-structure-orders
)- 特定の構造体(ステーション、シタデルなど)の全市場注文を取得
- ページネーション対応で大量のデータを効率的に取得可能
-
地域の取引所統計取得 (
get-market-stats
)- 特定の地域の市場統計情報を取得
- 取引量、価格トレンド、市場活性度などの指標を提供
-
構造体の特定アイテム注文取得 (
get-structure-type-orders
)- 特定の構造体における特定のアイテムタイプの全市場注文を取得
- より詳細な市場分析が可能
セットアップ
Installing via Smithery
To install eve-online-mcp for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @kongyo2/eve-online-mcp --client claude
-
依存パッケージのインストール:
npm install
-
プロジェクトのビルド:
npm run build
-
サーバーの起動:
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サーバーを起動
使用例
- 市場価格の取得:
// すべてのアイテムの価格を取得
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
});
認証設定
EVE Online SSO設定
-
EVE Online Developers Portalでアプリケーションを登録
-
以下のスコープを要求:
esi-markets.structure_markets.v1
esi-markets.read_character_orders.v1
-
取得したクライアントIDとシークレットを
.env
ファイルに設定:cp .env.example .env # .envファイルを編集して認証情報を設定
認証フロー
- 認証URLの取得:
const authUrlResponse = await callTool("get-auth-url", {
state: "unique-state-string"
});
// ユーザーをauthUrlResponseのURLにリダイレクト
- 認証コードの交換:
const authResponse = await callTool("authenticate", {
code: "authorization-code-from-callback"
});
// 返されたトークンを保存
- トークンの更新:
const refreshResponse = await callTool("refresh-token", {
refresh_token: "saved-refresh-token"
});
// 新しいトークンで更新
構造体アクセス
認証が必要な構造体のマーケットデータにアクセスする場合:
- 適切なスコープを持つトークンを取得
- makeESIRequestの呼び出し時にトークンを指定:
const structureOrders = await callTool("get-structure-orders", {
structure_id: 1234567890,
page: 1,
token: "your-access-token"
});
注意事項
-
構造体関連のエンドポイント
- 構造体関連のエンドポイントにアクセスするには、適切な権限を持つESIトークンが必要です
- アクセス権のない構造体のデータは取得できません
-
ページネーション
- 大量のデータを返すエンドポイントはページネーションを使用します
page
パラメータで特定のページを指定できます(1から開始)
-
キャッシュ
- ESIのレスポンスはサーバー側でキャッシュされます
- キャッシュ期間はエンドポイントによって異なります
- キャッシュ情報はレスポンスヘッダーで確認できます