Worldanvil MCP

🚀 WorldAnvil MCP

WorldAnvil 用のMCPサーバーです。WorldAnvilは、作家、ゲームマスター、クリエイター向けの世界構築プラットフォームです。

Claude Code、Cursor、Windsurf、Cline、およびMCP互換のAIツールと連携します。

🚀 クイックスタート

📦 インストール

Claude Code

/install wlcarden/worldanvil-mcp

次に、認証トークンを設定します。

export WA_AUTH_TOKEN="your-auth-token"

Cursor / Windsurf / その他のMCPクライアント

MCP設定に以下を追加します。

{
  "mcpServers": {
    "worldanvil": {
      "command": "npx",
      "args": ["worldanvil-mcp"],
      "env": {
        "WA_AUTH_TOKEN": "your-auth-token"
      }
    }
  }
}

npm (直接インストール)

npx worldanvil-mcp

または、グローバルにインストールする場合は、以下を実行します。

npm install -g worldanvil-mcp

セットアップ

1. https://www.worldanvil.com/api/auth/key から 認証トークン を取得します。
2. 取得したトークンを使ってAIツールを設定します（上記のインストール手順を参照）。

以上で完了です！MCPは公開プロキシを使用するため、アプリケーションキーは必要ありません。

✨ 主な機能

90以上のツールとの完全なWorldAnvil API統合が可能です。

• 記事 - 世界の記事（キャラクター、場所、アイテムなど）を作成、編集、管理します。
• カテゴリ - 階層的なカテゴリでコンテンツを整理します。
• マップとマーカー - インタラクティブなマップと場所のマーカーを管理します。
• タイムラインとイベント - 歴史的なイベントと時代を追跡します。
• 変数 - BBCodeをサポートする再利用可能なコンテンツスニペットです。
• シークレット - プレイヤーから隠されたGM専用の情報です。
• ノートブックとメモ - 個人用の整理ツールです。
• 原稿 - 長文の執筆プロジェクトです。
• その他 - ブロック、キャンバス、購読者グループ、RPGシステムなど。

📚 ドキュメント

インストール後、Claudeは包括的な世界構築ガイダンスにアクセスできます。

• 記事テンプレートとベストプラクティス
• BBCodeフォーマットのリファレンス
• コンテンツの関係パターン（@メンション、階層構造）
• キャンペーン管理ワークフロー

プロキシのセルフホスティング

独自のアプリケーションキーを使用する場合は、plugins/worldbuilding/worldanvil-mcp/cloudflare-worker/ を参照して、Cloudflare Workerのデプロイ手順を確認してください。

コントリビューション

イシューとプルリクエストを歓迎します！このプラグインはWorldAnvilコミュニティによってメンテナンスされています。

📄 ライセンス

MIT