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 许可证。