Evetycoon MCP Server

🚀 EVE Tycoon MCP Server

EVE Onlineの市場データにアクセスするためのEVE Tycoon APIを提供するModel Context Protocol (MCP)サーバーです。

🚀 クイックスタート

このMCPサーバーを使用すると、EVE Tycoon APIとやり取りして、さまざまな地域のEVE Onlineアイテムの市場データ、価格統計、注文帳、および過去の価格情報を取得できます。

✨ 主な機能

ツール

• get_market_stats：特定の地域のアイテムの価格と数量の統計情報を取得します。
• get_market_orders：メタデータ付きのアイテムタイプの現在の注文帳を取得します。
• get_market_history：地域内のアイテムの価格履歴を取得します。
• get_regions：すべてのEVE Online地域のリストを取得します。
• get_market_groups：すべての市場グループのリストを取得します。
• get_market_group_types：特定の市場グループ内のアイテムタイプのリストを取得します。

リソース

• EVE Tycoon API Documentation：APIエンドポイントと使用方法のクイックリファレンスです。

プロンプト

• market-analysis：特定のアイテムの市場データを見つけるためのクエリを生成します。
• comprehensive-analysis：アイテムの詳細な市場分析を実行します。

📦 インストール

Smitheryを通じたインストール

Smitheryを通じてClaude Desktop用のevetycoon-mcp-serverを自動的にインストールするには、次のコマンドを実行します。

npx -y @smithery/cli install @kongyo2/evetycoon-mcp-server --client claude

手動インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

💻 使用例

開発環境

開発モードでサーバーを起動します。

npm run dev

本番環境

サーバーをビルドして起動します。

npm run build
npm start

テスト

テストを実行します。

npm test

📚 ドキュメント

このMCPサーバーは、すべての文書化されたEVE Tycoon APIエンドポイントにアクセスできます。

市場API

• /v1/market/stats/{regionId}/{typeId} - 市場統計情報
• /v1/market/orders/{typeId} - 注文帳データ
• /v1/market/history/{regionId}/{typeId} - 価格履歴

静的データAPI

• /v1/market/regions - すべての地域
• /v1/market/groups - すべての市場グループ
• /v1/market/groups/{groupId}/types - 市場グループ内のタイプ

🔧 技術詳細

サーバーは https://evetycoon.com/api のEVE Tycoon APIに接続します。公開エンドポイントには認証は必要ありません。

レート制限

EVE Tycoon APIが返す Expires ヘッダーを尊重してください。サーバーは上流APIからのキャッシュ情報をそのまま渡します。

コード例

基本的な使用法

// The Forge地域のPLEXの市場統計情報を取得
{
  "regionId": 10000002,  // The Forge
  "typeId": 44992        // PLEX
}

高度な使用法

// 特定のアイテムのすべての注文を取得
{
  "typeId": 44992,       // PLEX
  "regionId": 10000002   // オプション: 地域でフィルタリング
}

// 価格履歴を取得
{
  "regionId": 10000002,  // The Forge
  "typeId": 44992        // PLEX
}

📄 ライセンス

MITライセンス

コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

免責事項

このツールは非公式のものであり、CCP GamesまたはEVE Onlineとは関係ありません。EVE OnlineはCCP hfの商標です。