Tarkov MCP

🚀 Tarkov MCP 服務器

這是一個模型上下文協議（MCP）服務器，可通過 tarkov.dev 的 GraphQL API 全面訪問《逃離塔科夫》遊戲數據。它能讓玩家和開發者輕鬆獲取遊戲中的各種詳細信息。

🚀 快速開始

此 MCP 服務器允許 AI 助手訪問《逃離塔科夫》的詳細信息，涵蓋物品、商人、地圖、任務、製作配方等。它旨在為需要塔科夫遊戲數據的玩家、開發者和 AI 應用程序提供全面的資源。

✨ 主要特性

可用工具

服務器提供 19 種不同的工具，用於訪問塔科夫數據的各個方面：

核心遊戲數據

• achievement - 返回《逃離塔科夫》的所有成就
• items - 返回全面的物品數據，包括屬性、價格和特性
• ammo - 返回詳細的彈藥信息，包括彈道數據
• armor-materials - 返回裝甲材料特性和耐久度數據

交易與經濟

• barter - 返回商人提供的所有以物易物交易
• traders - 返回商人信息、等級和報價
• flea-market - 返回跳蚤市場配置和費用

製作與藏身處

• crafts - 返回所有制作配方和要求
• hideout-stations - 返回藏身處站點信息和升級情況

任務與進度

• tasks - 返回所有任務，包括目標和獎勵
• quest-items - 返回僅用於任務的特殊物品
• skills - 返回玩家技能信息
• player-levels - 返回玩家等級進度數據
• mastering - 返回武器精通要求

地圖與地點

• maps - 返回詳細的地圖信息，包括出生點、撤離點和戰利品
• bosses - 返回首領信息，包括生命值、裝備和掉落物
• loot-containers - 返回戰利品容器位置和刷新幾率
• stationary-weapons - 返回固定武器信息

系統信息

• server-status - 返回當前塔科夫服務器狀態和消息

📦 安裝指南

1. 克隆此倉庫
2. 安裝依賴項：

   npm install
   

3. 配置環境變量（可選）：

   TARKOV_API_ENDPOINT=https://api.tarkov.dev/graphql
   TARKOV_LANG=en
   

💻 使用示例

運行服務器

npm start

服務器將啟動並監聽 MCP 連接。

配置

服務器可以通過環境變量進行配置：

• TARKOV_API_ENDPOINT - GraphQL API 端點（默認：https://api.tarkov.dev/graphql）
• TARKOV_LANG - 本地化內容的語言代碼（默認：en）

工具詳情

achievement

返回成就數據，包括：

• 成就名稱和描述
• 完成百分比
• 稀有度信息
• 側面要求（PMC/SCAV）

items

返回全面的物品數據，包括：

• 基本屬性（名稱、描述、尺寸、重量）
• 市場價格和趨勢
• 特定類型物品的屬性（武器、裝甲、消耗品等）
• 交易信息（以物易物、現金報價）
• 任務用途
• 製作配方

ammo

返回彈藥數據，包括：

• 彈道屬性（傷害、穿透、精度）
• 裝甲傷害和碎裂情況
• 後坐力和速度修正
• 曳光彈信息

barter

返回以物易物交易信息，包括：

• 所需物品和數量
• 獎勵物品和數量
• 商人和等級要求
• 任務解鎖要求

traders

返回商人信息，包括：

• 商人等級和要求
• 可用的以物易物和現金報價
• 聲望等級和獎勵
• 保險和修理費率

tasks

返回任務數據，包括：

• 目標和要求
• 獎勵（物品、經驗、商人好感度）
• 先決條件和解鎖條件
• 特定地圖信息

maps

返回詳細的地圖信息，包括：

• 出生點和撤離點
• 戰利品容器和散落戰利品位置
• 首領刷新信息
• 危險區域和特殊區域
• 鑰匙要求

crafts

返回製作配方數據，包括：

• 所需材料和數量
• 製作出的物品
• 製作站和等級要求
• 製作時長

hideout-stations

返回藏身處站點信息，包括：

• 升級要求（物品、技能、商人等級）
• 站點獎勵和效果
• 製作能力
• 建造時間和成本

📚 詳細文檔

API 參考

所有工具直接從 tarkov.dev 的 GraphQL API 以 JSON 格式返回數據。數據結構遵循 GraphQL 模式定義。

錯誤處理

服務器處理各種錯誤情況：

• 網絡連接問題
• API 速率限制
• 無效的 GraphQL 查詢
• 缺失或格式錯誤的數據

🔧 技術細節

項目結構

src/
├── config/          # 配置管理
├── logger/          # 日誌工具
├── tools/           # MCP 工具實現
│   └── items/       # 單個工具模塊
│       ├── achievements/
│       ├── ammo/
│       ├── barter/
│       └── ...
└── server.js        # 主 MCP 服務器

添加新工具

1. 在 src/tools/items/ 下創建一個新目錄
2. 用 GraphQL 查詢實現 loader.js
3. 用工具定義實現 index.js
4. 添加到 src/tools/items/index.js 的導出中

代碼風格

項目使用：

• ESLint 進行代碼檢查
• Prettier 進行代碼格式化

運行格式化和檢查：

npm run format
npm run lint

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

致謝

• tarkov.dev 提供了全面的塔科夫 API
• Model Context Protocol 提供了 MCP 規範
• 《逃離塔科夫》社區提供了數據驗證和反饋

支持

如有問題和疑問：

• 查看 tarkov.dev API 文檔
• 在本倉庫中創建一個 issue
• 加入社區討論