使用说明
世界Anvil MCP服务器
MCP（模型上下文协议）服务器，用于与World Anvil API接口，以协助D&D世界开发。
概述
此MCP服务器将Claude Code与World Anvil平台连接起来，通过结构化工具、资源和提示实现人工智能辅助的世界构建。专为D&D活动管理和创意写作而设计。
特性
- 内容管理：文章、块、类别、手稿
- 图谱整合：带有标记和图层的交互式地图
- 活动工具：RPG系统、时间表、会议记录
- D&D援助：NPC生成、位置设计、任务跟踪
- 笔记本系统：有组织的笔记和文件
先决条件
- Python 3.11+
- uv（快速Python包管理器）——https://docs.astral.sh/uv/
- 拥有大师公会会员资格的世界铁砧账户
- World Anvil API应用程序密钥
- World Anvil用户身份验证令牌
安装
# Clone repository and enter it
cd world-anvil
# Recommended: create a local virtualenv with uv
uv venv --python 3.11 .venv
# Activate the environment
# macOS/Linux
source .venv/bin/activate
# Windows (PowerShell)
.venv\\Scripts\\Activate.ps1
# Install dependencies (dev extras optional)
uv pip install -e .[dev]
# Tip: you can also run without activating via uv
uv run world-anvil-mcp
无紫外线：
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\Activate.ps1
pip install -e .[dev]
配置
创建一个 .env 文件：
WORLD_ANVIL_APP_KEY=your_application_key_here
WORLD_ANVIL_USER_TOKEN=your_user_token_here
用法
运行服务器
# Start MCP server with stdio transport
world-anvil-mcp
# Or run directly with Python
python -m world_anvil_mcp.server
使用克劳德代码
添加到MCP设置中：
{
"mcpServers": {
"world-anvil": {
"command": "world-anvil-mcp"
}
}
}
文档
项目状态
🚧 开发中——0.4阶段（早期实施）
- 起草架构和规范；初始服务器脚手架就位。
- 配置质量门（ruff、mypy、pytest）；正在添加测试。
- 看
docs/PHASE_0_STATUS.md用于详细的阶段跟踪和里程碑。
许可证
BSD 3条款许可证——详见许可证文件
