Tarkov MCP

🚀 Tarkov MCP Server

このModel Context Protocol (MCP)サーバーは、tarkov.devのGraphQL APIを通じて、Escape From Tarkovのゲームデータへの包括的なアクセスを提供します。

🚀 クイックスタート

このMCPサーバーを使用することで、AIアシスタントはEscape From Tarkovに関する詳細な情報にアクセスできます。これには、アイテム、トレーダー、マップ、クエスト、クラフトレシピなどが含まれます。これは、Tarkovのゲームデータを必要とするプレイヤー、開発者、AIアプリケーションにとって包括的なリソースとなるように設計されています。

✨ 主な機能

利用可能なツール

サーバーは、Tarkovのデータのさまざまな側面にアクセスするための19種類の異なるツールを提供します。

コアゲームデータ

• achievement - Escape From Tarkovのすべての実績を返します
• 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 - 現在のTarkovサーバーの状態とメッセージを返します

📦 インストール

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

🤝 コントリビュート

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. テストとリンティングを実行します
5. プルリクエストを送信します

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

謝辞

• tarkov.devによる包括的なTarkov APIの提供
• Model Context ProtocolによるMCP仕様の提供
• データの検証とフィードバックを提供してくれたEscape From Tarkovコミュニティの皆様