WorldAnvilのMCPサーバー - ライター、ゲームマスター、クリエイターのための世界構築プラットフォーム。

Claude Code、Cursor、Windsurf、Cline、およびMCP互換のAIツールで動作します。

インストール

##Claudeコード

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

カーソル/ウィンドサーフィン/その他MCPクライアント

MCP の設定に追加します。

##npm (ダイレクト)

またはグローバルにインストールします。

セットアップ

1. [https://www.worldanvil.com/api/auth/keyから**Authトークンを取得
2. トークンでAIツールを構成する(上記のインストールを参照してください)

です。 MCP はパブリックプロキシを使用しており、アプリケーションキーを必要としません。

##特徴

90以上のツールとの完全なWorldAnvil API統合:

-アーティクル - 世界記事(文字、場所、アイテムなど)の作成、編集、管理

• カテゴリ - 階層的なカテゴリでコンテンツを整理 -マップとマーカー - インタラクティブマップと位置マーカーを管理する -タイムライン&イベント - 歴史的出来事や時代を追跡する -Variables - BBCodeサポートによる再利用可能なコンテンツスニペット
• 秘密 - プレイヤーから隠されているGMのみ情報
• ノート&ノート - 個人的な組織ツール
• マニュアル - ロングフォームの書き込みプロジェクト

WorldAnvil MCP

MCP server for WorldAnvil - the worldbuilding platform for writers, game masters, and creators.

Works with Claude Code, Cursor, Windsurf, Cline, and any MCP-compatible AI tool.

Installation

Claude Code

/install wlcarden/worldanvil-mcp

Then set your auth token:

export WA_AUTH_TOKEN="your-auth-token"

Cursor / Windsurf / Other MCP Clients

Add to your MCP configuration:

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

npm (Direct)

npx worldanvil-mcp

Or install globally:

npm install -g worldanvil-mcp

Setup

1. Get your Auth Token from https://www.worldanvil.com/api/auth/key
2. Configure your AI tool with the token (see installation above)

That’s it! The MCP uses a public proxy so you don’t need an Application Key.

Features

Full WorldAnvil API integration with 90+ tools:

• Articles - Create, edit, and manage world articles (characters, locations, items, etc.)
• Categories - Organize content with hierarchical categories
• Maps & Markers - Manage interactive maps and location markers
• Timelines & Events - Track historical events and eras
• Variables - Reusable content snippets with BBCode support
• Secrets - GM-only information hidden from players
• Notebooks & Notes - Personal organization tools
• Manuscripts - Long-form writing projects
• And more - Blocks, canvases, subscriber groups, RPG systems

Documentation

Once installed, Claude has access to comprehensive worldbuilding guidance:

• Article templates and best practices
• BBCode formatting reference
• Content relationship patterns (@-mentions, hierarchies)
• Campaign management workflows

Self-Hosting the Proxy

If you prefer to use your own App Key, see plugins/worldbuilding/worldanvil-mcp/cloudflare-worker/ for Cloudflare Worker deployment instructions.

Contributing

Issues and PRs welcome! This plugin is maintained by the WorldAnvil community.

License

MIT