Dnd MCP

🚀 D&D 知識ナビゲーター

Python ベースのサーバーで、モデルコンテキストプロトコル（MCP）を実装し、Claude などの人工知能アシスタントを《ドラゴン アンド ダンジョン》第5版（D&D 5e）のゲーム情報に接続します。

🚀 クイックスタート

D&D 知識ナビゲーターは、Python ベースのサーバーで、モデルコンテキストプロトコル（MCP）を利用して、Claude などの AI アシスタントを D&D 5e のゲーム情報に接続します。以下に、基本的な使い方を説明します。

インストール

開発用インストール

# リポジトリをクローン
git clone https://github.com/yourusername/dnd-knowledge-navigator.git
cd dnd-knowledge-navigator

# 仮想環境を作成してアクティブ化
python -m venv .venv
source .venv/bin/activate  # Windowsの場合は：.venv\Scripts\activate

# 開発モードでパッケージをインストール
pip install -e .

依存関係のインストール

pip install -r requirements.txt

サーバーの設定

1. 設定ファイルの作成
   プロジェクトのルートディレクトリに config.json ファイルを作成し、以下の内容を追加します。

   {
     "api_key": "your_api_key_here",
     "debug_mode": true,
     "port": 5000
   }
   

2. 環境変数の設定
   以下の環境変数を設定してください。
   • DND_API_KEY：D&D API へのアクセスに必要なキー。
   • DEBUG_MODE：デバッグモードを有効にする（オプション）。

サーバーの起動

python dnd_mcp_server.py

テストの実行

./run_tests.py

✨ 主な機能

MCP とは？

モデルコンテキストプロトコル（MCP）は、Anthropic によって開発されたフレームワークで、Claude などの人工知能アシスタントが外部のツールやサービスと通信できるようにします。このサーバーは、FastMCP（Anthropic ツールの Python 実装）を利用して、これらの機能を D&D 5e のデータに接続します。

主な機能の詳細

1. コア機能
   • D&D 5e データへのアクセスインターフェースを提供します。
   • MCP プロトコルを実装し、Claude などの AI アシスタントとの通信をサポートします。
2. 出所帰属システム
   • データの出所情報を記録および管理します。
   • カスタム出所識別子と引用情報をサポートします。
3. クエリ強化システム
   • 複雑なクエリ要求を処理します。
   • 同義語サポートと曖昧なマッチング機能を提供します。
4. テンプレートシステム
   • 美しい応答出力を生成します。
   • さまざまなニーズに対応するためのカスタムテンプレートをサポートします。

📦 インストール

上述の「クイックスタート」の「インストール」セクションを参照してください。

💻 使用例

基本的な使用法

まず、サーバーを起動します。

python dnd_mcp_server.py

その後、AI アシスタントを介して D&D 5e のデータにアクセスできます。

📚 ドキュメント

プロジェクトには、パッケージ構造、インストールガイド、実行手順、および貢献フローを含む詳細なドキュメントが用意されています。詳細については、docs ディレクトリの内容を参照してください。

🔧 技術詳細

プロジェクト構造

D&D 知識ナビゲーターは Python パッケージとして、以下の構造を持っています。

dnd-knowledge-navigator/
├── dnd_mcp_server.py      # メインサーバーのエントリーポイント
├── run_tests.py           # すべてのテストを実行するスクリプト
├── setup.py               # インストール設定ファイル
├── src/                   # ソースコードディレクトリ
│   ├── __init__.py        # パッケージの初期化
│   ├── attribution/       # 出所帰属システム
│   ├── core/              # コア機能
│   ├── query_enhancement/ # クエリ強化システム
│   └── templates/         # 応答フォーマットテンプレート
├── tests/                 # テストディレクトリ
│   ├── __init__.py        # テストパッケージの初期化
│   └── test_*.py          # テストファイル
└── docs/                  # ドキュメント

📄 ライセンス

このプロジェクトは MIT ライセンスの下で配布されています。詳細については、LICENSE ファイルを参照してください。

謝辞

• D&D 5e API は D&D データを提供しています。
• Anthropic はモデルコンテキストプロトコルを開発しました。
• FastMCP は MCP の Python 実装を提供しています。

貢献

貢献を歓迎します！自由にプルリクエストを送信してください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add some amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを開きます。