Worldanvil MCP

🚀 WorldAnvil MCP

WorldAnvil MCP 是 WorldAnvil 的 MCP 服務器。WorldAnvil 是一個面向作家、遊戲主持人和創作者的世界構建平臺。

該項目可與 Claude Code、Cursor、Windsurf、Cline 以及任何支持 MCP 的 AI 工具配合使用。

🚀 快速開始

你可以按照以下步驟完成 WorldAnvil MCP 的安裝和配置：

1. 獲取認證令牌：從 https://www.worldanvil.com/api/auth/key 獲取你的 認證令牌。
2. 安裝並配置：根據你使用的工具，選擇合適的安裝方式，並使用獲取到的認證令牌進行配置（具體安裝方式見下方“📦 安裝指南”）。

完成以上步驟後，MCP 會使用公共代理，因此你無需應用密鑰。

📦 安裝指南

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

✨ 主要特性

WorldAnvil MCP 實現了與 90 多種工具的全面集成，提供以下功能：

• 文章管理：創建、編輯和管理世界文章（包括角色、地點、物品等）。
• 分類組織：使用分層類別對內容進行組織。
• 地圖與標記：管理交互式地圖和位置標記。
• 時間線與事件：跟蹤歷史事件和時代。
• 變量管理：支持 BBCode 的可重複使用內容片段。
• 秘密信息：僅供遊戲主持人查看的信息，對玩家隱藏。
• 筆記與筆記本：個人組織工具。
• 手稿創作：長篇寫作項目。
• 更多功能：塊、畫布、訂閱者組、RPG 系統等。

📚 詳細文檔

安裝完成後，Claude 可以訪問全面的世界構建指南，包括：

• 文章模板和最佳實踐。
• BBCode 格式參考。
• 內容關係模式（@提及、層次結構）。
• 活動管理工作流程。

🔧 技術細節

如果你希望使用自己的應用密鑰，可以參考 plugins/worldbuilding/worldanvil-mcp/cloudflare-worker/ 中的說明進行 Cloudflare Worker 部署。

🤝 貢獻

歡迎提交問題和拉取請求！此插件由 WorldAnvil 社區維護。

📄 許可證

本項目採用 MIT 許可證。