Grimoire for Gamemasters

Grimoire MCP：Claude と ChatGPT 向け D&D・テーブルトーク RPG キャンペーンマネージャー

Grimoire for Gamemasters の公式ホスト型 MCP サーバーです。あなたの D&D キャンペーンは、AI が読み書きするリアルタイムの型付きデータベースになります。自分で管理する Markdown ファイルではありません。

エンドポイント	https://api.ttrpg.bot/mcp
トランスポート	Streamable HTTP（MCP spec 2025-06-18）
認証	PKCE を使用する OAuth 2.1、ワンクリックの同意フロー
ツール	8 グループにわたる 52 個（読み取り 21 個、書き込み 31 個）
レジストリ	公式 MCP Registry の bot.ttrpg/grimoire
ウェブアプリ	https://www.ttrpg.bot

Grimoire とは？

Grimoire for Gamemasters は、ダンジョンズ＆ドラゴンズやその他のテーブルトーク RPG 向けのキャンペーンマネージャーです。世界を運営するダンジョンマスターや GM のために作られています。このリポジトリでは、公式 MCP サーバーについて説明しています。このサーバーを使うと、Claude、ChatGPT、Cursor、その他の MCP クライアントからキャンペーンを直接読み書きできます。Grimoire のキャンペーンはメモのフォルダーではなく、型付きデータベース兼ナレッジグラフです。NPC、勢力、場所、クエスト、セッションの振り返り、伝承が関係性で結ばれており、それらの記録にリンクするページを備えた共同編集型 Wiki もあります。AI は現在の正史に基づいて回答し、セッションの合間にキャンペーンが変化しても一貫性を保ちます。

キャンペーンのファイルをフォルダーに保存する場合との違いは、AI が取得する情報にあります。ファイル検索では、古くなっている可能性のある文章が返されます。Grimoire が返すのは型付きの状態です。たとえば、勢力の現在のリーダー、未解決のプロットとそれが何セッションにわたって持ち越されているか、ある NPC に言及している Wiki ページ、卓で正史と認定された事実などです。書き込みも同じ構造に反映されるため、チャットから記録した情報が古くなることはありません。

D&D 5e、Pathfinder 2e、Call of Cthulhu、Shadowdark、自作の設定、その他あらゆるシステムで使えます。記録が表すのは世界そのものであり、ルールエンジンではありません。

Grimoire の使い方

3 回クリックするだけです。インストールは不要です。

1. コネクターを追加します。 Claude.ai（無料プランにはカスタムコネクターが 1 つ含まれます）、ChatGPT（Developer Mode を利用できる Plus または Pro）、またはカスタムコネクターに対応する任意の MCP クライアントで、Settings、Connectors、Add custom connector の順に開き、https://api.ttrpg.bot/mcp を貼り付けます。
2. サインインしてキャンペーンを選びます。 クライアントで Grimoire の同意画面が開きます。キャンペーンを所有するアカウントでサインインし、AI に表示するキャンペーンを選んで Approve をクリックします。アクセスはそのキャンペーンのみに限定され、サーバー側で適用されます。
3. 世界について質問します。 「カルトのことを知っているのは誰？」 「第 4 セッションで女王はどんな反応をした？」 「第 12 セッションから何が変わった？」 クライアントは最新情報を読み取り、あなたのデータに基づいて回答します。

クライアントごとの手順を含むセットアップの詳しい説明：https://www.ttrpg.bot/docs/mcp/

コネクターの UI ではなく JSON ファイルで設定するクライアントの場合：

{
  "mcpServers": {
    "grimoire": {
      "type": "streamable-http",
      "url": "https://api.ttrpg.bot/mcp"
    }
  }
}

認証には PKCE を使用する OAuth 2.1 を採用しています。初回接続時に、クライアントからブラウザーでサインイン画面が開きます。サーバーが読み取るキャンペーンは、https://www.ttrpg.bot で無料の Grimoire アカウントを作成すると利用できます。

Grimoire の主な機能

• フラットファイルではなく、型付きのライブ状態。 14 のエンティティスキーマを備えた型付きキャンペーンデータベースで、52 個のツール（読み取り 21 個、書き込み 31 個）を利用できます。ナラティブ状態を 1 回呼び出すだけで、最近のセッション、未解決のプロットスレッド、進行中のアーク、正史の事実を取得できます。
• 読み取りと書き込みに対応し、状態を最新に保ちます。 会話から NPC、派閥、場所、クエストを作成・更新し、スレッドの進行状況を記録して、Wiki ページ、ブロック、テーブルを書き込めます。そのため、準備中に正史が更新され、ファイルの中で古くなることがありません。
• Wiki も世界の一部です。 全文検索、パンくずリストと子ページを備えたページ、Markdown のグリッドとして往復変換できるテーブル、文字列の一致ではなく実際のレコードを参照するエンティティリンクとページリンクを利用できます。
• 政治、地理、タイムラインの各投影を対象としたナレッジグラフクエリに対応し、GM の閲覧権限によるフィルタリングはサーバー側で適用されます。
• GM の秘密はサーバー側で保護されます。 3 段階の可視性（共有知識、プレイヤー知識、GM の秘密）により、AI が提示できる情報はプレイヤーに公開可能な情報に限られます。
• プレイヤーとの接続にも対応します。 GM がキャンペーンでプレイヤー向け AI を有効にすると、プレイヤーは自分の AI を接続し、プレイヤーポータルに表示される情報だけを読み取れます。GM が秘密にしている情報は一切表示されません。
• ホステッド型で、OAuth をワンクリックするだけ。トークンのマークアップも不要です。 OAuth 2.1 を使用したリモートのストリーミング可能な HTTP に対応しています。インストールもセルフホストも不要です。無料プランには MCP アクセスが含まれ、Grimoire が AI トークンの料金を請求することはありません。

Grimoire のユースケース

• セッション 13 の準備を始める前に、セッション 12 から何が変わったかを質問できます。メモの記憶に頼らず、追跡された状態から回答が得られます。
• セッション中に、モデルの推測ではなくキャンペーンの正史に基づいて情報を確認できます。
• 今夜の準備メモを型付きの NPC、派閥、プロットスレッドに変換できます。同じ設定を新しいチャットのたびに貼り付ける必要はありません。
• 関係性を軸に世界を検索できます。たとえば、この都市に関わる利害を持つ派閥や、パーティに気づきそうな NPC を調べられます。
• Wiki で水没した修道院に言及したハンドアウトを検索し、そのページとリンク先のエンティティを読み取れます。
• セッションの振り返りを下書きし、プレイヤーがポータルで読めるよう、プレイヤーの可視性レベルに合わせた構造化エンティティとして保存できます。
• 他の MCP サーバーと連携できます。前回のセッションをスライドショーやナレーションのサーバーに渡したり、カレンダーサーバーにつないで、ボットに準備を促すリマインダーを設定したりできます。

ツールボックス

8つのグループにわたる52個のツールです。

エンティティ（10個）：search_campaign、get_entity、list_entities、get_field_options、get_tag_options、get_entity_schema、create_entity、update_entity、delete_entity、batch_create_entities。14種類すべてのエンティティに対応しています：NPC、場所、勢力、クエスト、アイテム、プレイヤーキャラクター、クリーチャー、乗り物、ロア項目、世界のルール、次元界の力、セッションの振り返り、セッションの準備、カスタムメカニクス。get_entity_schema は、カテゴリーが受け付ける正確なフィールド、ネイティブ列、選択肢、キャンペーンのカスタムフィールドを報告するため、何でも入る汎用の入れ物ではなく、適切な場所に書き込めます。

リレーションシップ（3個）：add_relationship、get_relationships、delete_relationship。任意の2つのエンティティ間に、型付きのエッジを作成します。

ナレッジグラフ（8個）：get_constitution、get_entity_catalog、get_knowledge_graph、list_entity_graphs、get_entity_graph、add_to_entity_graph、create_entity_graph_edge、toggle_graph_attention。可視性フィルタリングに対応した、政治、タイムライン、地理、基盤の各投影を提供します。get_constitution はどちらのロールでも第1層の読み取りに使えます。GM 接続では憲法レイヤー全体を取得でき、プレイヤー接続では GM が共有対象に選んだ部分を取得でき、それぞれ応答内で明示されます。

世界の基盤（6個）：create_foundation_node、update_foundation_node、delete_foundation_node、create_foundation_edge、delete_foundation_edge、update_world_foundations。常に読み込まれるキャンペーンの基盤レイヤーを書き込むためのツールです。基盤ノードは、ラベル付きエッジでつながれた、世界を定義する概念（大災厄、隠された力、宇宙論的な法則など）です。また、update_world_foundations は、構造化された「世界の基盤」ドキュメント（魔法体系、神々の階層、根本法則）を設定します。これらは世界の力学的・宇宙論的な真実であり、NPC や場所などのデータベースエンティティとは異なります。

未解決のスレッド（7個）：get_open_threads、create_open_thread、resolve_open_thread、unresolve_open_thread、update_open_thread、get_thread_progressions、add_thread_progression。未解決の事柄と、セッションごとのその変化を扱います。

Wiki（10個）：get_wiki_tree、get_wiki_page、search_wiki、create_wiki_page、create_wiki_block、update_wiki_block、move_wiki_block、delete_wiki_block、batch_create_wiki_blocks、batch_reorder_wiki_blocks。AI がユーザーと同じように読み書きできる、ブロックベースの共同編集ページです。search_wiki はページタイトルとブロックの本文を全文検索します（search_campaign はエンティティのみを検索します）。表は通常の Markdown グリッドとして読み書きされ、エンティティリンク（@[Name](entity://category/uuid)）とページリンク（@[Title](page://uuid)）は、表のセルを含むすべてのブロック内で往復変換されます。そのため、AI が書いたページも、ユーザーが入力したページと同じようにレコードにリンクされます。

キャンペーンのメタデータ（5個）：current_campaign、get_campaign_context、get_narrative_state、get_campaign_bible、update_campaign_bible。get_narrative_state は、最近のセッション、未解決のスレッド、正史として確定した事実、進行中のアークを1つのビューに集約します。get_campaign_bible は GM 接続にはすべてのブロックを返し、プレイヤー接続には「共通知識」ブロックのみを返します。プレイヤー接続に返されるのは、GM がバイブルの共有を有効にしている場合に限られます。

セッションの観察記録（3個）：create_session_observation、update_session_observation、delete_session_observation。セッションに彩りを添える GM 専用のメモで、後から振り返る価値のある、型と評価が付いた出来事です。読み取り専用のツールは不要です。get_narrative_state は要約対象のセッションに関する観察記録を返し、get_knowledge_graph は描画するタイムライン上の観察記録を返すためです。

サーバーは、キャンペーンの Wiki ページとその階層を一覧表示する MCP リソース campaign://wiki も公開します。

うまく使いこなすためのスキル

skills/grimoire-campaign-context/ は Claude Skill（どのクライアントでも通常の指示として利用可能）で、セッション開始時の集中手順、どの読み取りツールを使うか、型付きエンティティを誤ったフィールドにデータを詰め込まずに記述する方法、準備メモの解析、振り返りの記録、セッション前の情報取得の手順をアシスタントに教えます。クライアントに参照させるか、プロジェクトの指示に貼り付けてください。

可視性と安全性

すべてに Grimoire の可視性モデルが適用されます。common-knowledge、player-knowledge、dm-secret、および（wiki のみ）system があり、inherit は wiki ページをリンクするブロックとその親階層をたどって解決されます。AI には、接続中のロールに許可された情報だけが表示されます。プレイヤー接続にはフィルタリングされたビューが表示され、プレイヤーがアクセスできないページは、その接続からは存在しません。検索、ツリー、ページの読み取りはいずれも「見つかりません」と応答します。GM 接続には全情報が表示されます。

Campaign Bible はデフォルトで GM Secret です。プレイヤーが知っていてよい情報（世界の仕組み、日常生活など）をブロックに記録する場合は、common-knowledge に設定します。これにより、その情報はプレイヤーに公開しても安全なものとして記録されます。その後、GM は Bible の共有を有効にできます。プレイヤー接続では get_campaign_bible と get_constitution を通じて Common Knowledge ブロックを読み取れますが、それ以外は読み取れません。共有が無効の場合、get_campaign_bible はエラーではなく通常の結果 {"shared": false, "message": "..."} を返し、get_constitution は shared.bible を false として報告し、Bible セクションを省略します。これにより、アシスタントは再試行せず、プレイヤーにその旨をはっきり伝えられます。Bible の名前は変更できません。

World Foundations も同じ方法で共有されますが、専用のフラグで管理されます。get_knowledge_graph(graph_type='foundations') と get_constitution の foundationNodes は、GM が Foundations の共有を有効にした場合にのみプレイヤー接続からアクセスできます。その場合も、プレイヤーに公開しても安全な情報だけが表示され、GM Secret のノードと、それらに接続するすべてのエッジは除外されます。どちらのフラグもキャンペーンのポータルポリシーの対象です。wiki 専用ポータルでは、フラグの設定にかかわらず、これらの読み取りは拒否されます。

OAuth スコープはキャンペーンごとに設定されます。あるキャンペーンへのアクセスを許可しても、ほかのキャンペーンへのアクセスは許可されません。アクセス権はいつでも取り消せます。

料金

最初から最後まで無料で試せます。Grimoire の無料プランには、最大 100 個のエンティティを含む 1 つのキャンペーンへの MCP アクセスが含まれており、カード登録不要でカスタムコネクターを 1 つ利用できる Claude の無料プランと組み合わせて使えます。ChatGPT のカスタムコネクターには、Developer Mode を利用できる Plus または Pro が必要です。Pro では、キャンペーン数とエンティティ数が無制限になり、すべてのカテゴリでカスタムフィールドを使えるようになるほか、ストレージも増えます。Grimoire は AI トークンの料金を請求しません。ご自身のクライアントをご用意ください。

料金：https://www.ttrpg.bot/#pricing

Grimoire のよくある質問

Claude や ChatGPT に D&D キャンペーンの読み取りと編集をさせる MCP サーバーはありますか？

はい。Grimoire のホスト型 MCP サーバー https://api.ttrpg.bot/mcp を使うと、Claude、ChatGPT、Cursor、その他の MCP クライアントから、Grimoire のキャンペーンにある NPC、派閥、ロケーション、クエスト、セッションの振り返り、伝承、未解決のプロット、キャンペーン wiki を読み書きできます。OAuth をワンクリックで接続し、AI に表示するキャンペーンを選択できます。

Grimoire のソースコードはどこにありますか？

MCP サーバーはホスト型サービスとして運用されており、ソースコードは公開されていません。このリポジトリは公開ドキュメントとレジストリアーティファクトです。ここにある server.json は bot.ttrpg/grimoire として registry.modelcontextprotocol.io に公開されており、lhm.plugin.json は LobeHub Marketplace のマニフェスト、skills/ は Claude Skill を収録しています。

Grimoire には標準の MCP 設定が含まれていますか？

はい。上記のストリーミング可能な HTTP ブロックを使うか、設定を省略してください。カスタムコネクターに対応するクライアントなら、URL https://api.ttrpg.bot/mcp だけで接続できます。

無料ですか？

はい、お試しいただけます。Grimoireの無料プランには、最大100件のエンティティを登録できる1つのキャンペーン向けMCPアクセスが含まれており、Claudeの無料プランでは、カードの登録なしでカスタムコネクタを1つ利用できます。ChatGPTでカスタムコネクタを使うには、Developer Modeを有効にしたPlusまたはProが必要です。

どのクライアントで使えますか？

Claude（ウェブ版とデスクトップ版）、ChatGPT（Developer Modeを有効にしたPlusまたはPro）、Cursor、およびリモートのストリーミング可能なHTTPサーバーと通信できる、MCP対応のクライアントで利用できます。

Pathfinder、Call of Cthulhu、自作システムでも使えますか？

はい。Grimoireは特定のシステムに依存しません。キャンペーンはD&D 5e、Pathfinder 2e、Call of Cthulhu、Shadowdarkなど多くのシステムや自作の設定に合わせてセットアップできます。ジャンルによって変わるのはラベルとデフォルト設定であり、AIにできることは変わりません。ツールはキャラクターシートのルールではなく、世界（人物、場所、派閥、歴史、スレッド）を読み書きします。

Wikiを読み書きできますか？

はい。search_wikiはテキストからページとブロックを検索し、get_wiki_pageはブロック、パンくずリスト、子ページを含むページを返します。また、書き込みツールでページ、ブロック、テーブルを作成できます。テーブルはMarkdown形式のグリッドとして扱われ、エンティティとページへのリンクは、サーバーが実際のレコードに解決するトークンとして保持されます。

キャンペーンのメモをMarkdownファイルで管理する場合と、どう違いますか？

ファイルには文章が保存されますが、AIはどのファイルが最新かを推測し、セッションごとに読み直す必要があります。Grimoireには型付きの状態が保存されます。フィールドと関連を持つレコード、経過期間付きのスレッド、正史としてマークされた事実、レコードにリンクされたページなどです。AIは現在の状態を照会し、同じ構造に変更を書き戻すため、セッション間で情報が食い違うことはありません。

ワールド構築に使うWorld Anvil、Obsidian、Notionとはどう違いますか？

これらのツールはページを保存し、接続されたAIはページを読み取ります。一方、Grimoireは型付きのレコードとその間の関連を保存するため、AIはキャンペーンをたどれます。たとえば、ある都市から、その都市に利害関係を持つ派閥、派閥を率いるNPC、NPCが関わる未解決のスレッドへとたどれます。GMの秘密はサーバー側でフィルタリングされます。すでに別の場所にメモがある場合は、AIがチャットでそれを読み取り、型付きのエンティティとしてGrimoireに保存できます。

接続すると、キャンペーンがAIベンダーと共有されますか？

ご自身のクライアントを使用します。Grimoireは、許可した1つのキャンペーンだけをそのクライアントに公開し、それ以外は公開しません。アクセス権限は同意画面に表示され、いつでも取り消せます。

リンク

• 製品：https://www.ttrpg.bot
• MCPの概要と接続手順：https://www.ttrpg.bot/mcp
• 詳細なセットアップガイド：https://www.ttrpg.bot/docs/mcp/
• キャンペーンのナレッジグラフ：https://www.ttrpg.bot/campaign-knowledge-graph/
• キャンペーンWiki：https://www.ttrpg.bot/dnd-campaign-wiki/
• 変更履歴：https://www.ttrpg.bot/changelog
• サポート：[email protected]

ライセンス

MIT（このドキュメントリポジトリに適用）。