tarkov-mcp

🚀 逃离塔科夫MCP服务器

这是一个模型上下文协议（MCP）服务器，它通过 tarkov.dev 的GraphQL API，为用户提供对《逃离塔科夫》游戏数据的全面访问。这个服务器能让AI助手获取关于《逃离塔科夫》的详细信息，涵盖物品、商人、地图、任务、制作配方等诸多方面，是玩家、开发者以及需要塔科夫游戏数据的AI应用的综合性资源。

🚀 快速开始

本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

返回藏身处站点信息，包括：

• 升级要求（物品、技能、商人等级）
• 站点奖励和效果
• 制作能力
• 建造时间和成本

📚 详细文档

所有工具直接从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
• 加入社区讨论