RPG Generator MCP Server

RPG Generator MCP Server

TypeScript と公式の MCP SDK を使用して構築された、ランダムなテーブルトップ RPG コンテンツ（キャンペーンのアイデアやファンタジー地域の属性）を生成する Model Context Protocol（MCP）サーバーです。

これは何ですか？

このプロジェクトは、LLM がランダムなテーブルトップ RPG コンテンツを生成するために使用できる、シンプルな Model Context Protocol（MCP） サーバーの構築方法を示します。

MCP は、AI モデルが専門的なツールやデータソースに接続するための共通の方法を提供するオープン標準です。MCP 仕様を実装することで、このサーバーは LLM がランダムなキャンペーンのアイデアやファンタジー地域の属性を生成できるようにします。無関係な要素同士のつながりを生み出し、創造性を刺激するのに役立ちます。

このサーバーには、主に 2 つの機能があります。

• random_campaign_idea - キャラクターの種類、舞台、映画からの着想を組み合わせて、ランダムなキャンペーンのアイデアを生成します
• random_region_attributes - ファンタジー世界の構築に向けて、ランダムな地域タグ、人口レベル、人口の特徴を生成します

ランダム生成器を使う理由

ゲームマスターが一見無関係な要素同士を結び付けて創造性を刺激するためにランダム表を使うのと同じように、LLM はランダムな入力によって予測可能なパターンから抜け出すことができます。このプロジェクトは、MCP を専門的なツール接続に活用し、LLM の創造的な能力を拡張する方法を示します。

はじめに

前提条件

• Node.js
• npm

インストール

1. リポジトリをクローンします。

git clone https://github.com/guyroyse/rpg-generator-mcp-server.git
cd rpg-generator-mcp-server

2. 依存関係をインストールします。

npm install

3. ビルドしてインストールします。

npm run build

MCP サーバーの使用方法

Claude で使用する

1. Claude デスクトップアプリで Claude を開きます。

2. 「Settings」に移動し、「Developer」を選択して、「Edit Config」ボタンをクリックします。これにより、claude_desktop_config.json ファイルが格納されているフォルダーが開きます。

3. JSON ファイルにサーバーを追加します。

{
  "mcpServers": {
    "rpg-generator": {
      "command": "rpg-generator-mcp-server"
    }
  }
}

4. Claude Desktop を終了して再起動します。
5. Claude に、ランダムなキャンペーンのアイデアや地域の属性を生成するよう依頼できるようになります。

プロンプトの例：

• 「自分の TTRPG 用にランダムなキャンペーンのアイデアを生成してください」
• 「ファンタジー世界に使うランダムな地域がいくつか必要です」

関数リファレンス

random_campaign_idea

パラメーター：なし

レスポンス：以下を組み合わせたキャンペーンのアイデアを説明する文字列です。

• キャラクターの種類（例：「傭兵」「脱獄囚」「アスリート」）
• 舞台（例：「フェイワイルド」「メカ」「アーバンファンタジー」）
• 映画からの着想（例：「ジュラシック・パーク」「プリンセス・ブライド・ストーリー」「エイリアン」）

レスポンスの例：

The players are Escaped Prisoners adventuring in a Mecha setting experiencing events similar to the movie Jurassic Park.

random_region_attributes

パラメーター：なし

レスポンス：以下を含む Markdown 形式の文字列です。

• 地域タグ（説明付きのランダムなタグ 2 件）
• 人口レベル（集落の密度と規模）
• 人口の特徴（文化的または社会的な特性）

レスポンスの例：

**Region Tags**
Feral Magic: Region where magic has become untamed and manifests as semi-sentient predatory phenomena.
Monastic Retreat: Area dotted with monasteries and meditation sites, often with unique fighting or magical traditions.

**Population Level**
Outpost: A tiny settlement of 10-50 individuals, possibly a trading post, watchtower, research station, or religious retreat. Extremely isolated with minimal facilities.

**Population Characteristic**
Military Tradition: Martial skills are highly valued, with many citizens receiving combat training regardless of their primary occupation. This might stem from a history of conflict, strategic location, or cultural values. Martial accomplishments bring prestige, and military leaders often hold political authority as well.

サーバーの拡張

このプロジェクトには、ランダム生成器を簡単に追加できます。独自の生成器を追加するには、次の手順に従います。

1. 既存の 生成器を参考に、新しい生成関数を作成します。
2. mcp-server.ts で、生成器をツールとして追加します。
3. ビルドします。

ビルドやインストールをせずに MCP サーバーをテストする場合は、MCP Inspector を使用できます。

npm run inspect

謝辞

• 公式の Model Context Protocol SDK を使用して構築
• Model Context Protocol の仕様を実装
• 数え切れないほどの時間にわたるテーブルトップ RPG の楽しさに着想を得ています