Evetycoon MCP Server

🚀 EVE Tycoon MCP 服務器

EVE Tycoon MCP 服務器是一個模型上下文協議（MCP）服務器，它提供對 EVE Tycoon API 的訪問，用於獲取 EVE Online 市場數據。

🚀 快速開始

這個 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 文檔：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 的緩存信息。

基礎用法

獲取 PLEX 在 The Forge 地區的市場統計信息

// 使用 get_market_stats 工具
{
  "regionId": 10000002,  // The Forge
  "typeId": 44992        // PLEX
}

獲取特定物品的所有訂單

// 使用 get_market_orders 工具
{
  "typeId": 44992,       // PLEX
  "regionId": 10000002   // 可選：按地區過濾
}

獲取價格歷史記錄

// 使用 get_market_history 工具
{
  "regionId": 10000002,  // The Forge
  "typeId": 44992        // PLEX
}

📄 許可證

本項目採用 MIT 許可證。

貢獻說明

歡迎貢獻代碼！請隨時提交拉取請求。

免責聲明

這是一個非官方工具，與 CCP Games 或 EVE Online 沒有關聯。EVE Online 是 CCP hf 的商標。