Eve Online MCP

🚀 EVE Online市場MCP服務器

本MCP服務器為訪問EVE Online的市場數據提供接口。藉助ESI（EVE Swagger Interface）API，能夠獲取即時的市場數據。

🚀 快速開始

認證與速率限制

此服務器目前僅獲取公共市場數據，因此無需ESI認證。不過，存在以下限制和規範：

1. 速率限制
   • ESI有每分鐘的錯誤限制。
   • 服務器會自動監控速率限制，若達到限制則返回錯誤。
   • 可通過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的詳細錯誤信息。

✨ 主要特性

服務器提供以下三項主要功能：

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

💻 使用示例

基礎用法

1. 獲取市場價格

// 獲取所有物品的價格
const prices = await callTool("get-market-prices");

2. 獲取市場訂單

// 獲取The Forge（區域ID: 10000002）的Tritanium（類型ID: 34）的訂單
const orders = await callTool("get-market-orders", {
  region_id: 10000002,
  type_id: 34,
  order_type: "all"
});

3. 獲取市場歷史

// 獲取The Forge的Tritanium的市場歷史
const history = await callTool("get-market-history", {
  region_id: 10000002,
  type_id: 34
});

4. 獲取分組市場數據

// 獲取The Forge的Tritanium的分組市場數據
const marketGroups = await callTool("get-market-groups", {
  region_id: 10000002,
  type_id: 34
});

5. 獲取結構體的市場訂單

// 獲取結構體ID: 1234567890 的所有市場訂單
const structureOrders = await callTool("get-structure-orders", {
  structure_id: 1234567890,
  page: 1
});

6. 獲取區域交易市場統計信息

// 獲取The Forge的市場統計信息
const marketStats = await callTool("get-market-stats", {
  region_id: 10000002
});

7. 獲取結構體特定物品的訂單

// 獲取結構體ID: 1234567890 中Tritanium的所有市場訂單
const typeOrders = await callTool("get-structure-type-orders", {
  structure_id: 1234567890,
  type_id: 34,
  page: 1
});

📚 詳細文檔

認證設置

EVE Online SSO設置

1. 在EVE Online開發者門戶註冊應用程序。
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的響應會在服務器端進行緩存。
   • 緩存期限因端點而異。
   • 可通過響應頭查看緩存信息。

📄 許可證

文檔中未提及許可證相關信息。