WulaFallenEmpireRW/MCP/使用指南.md

RimWorld 知识库 - 绕过 Qoder IDE 使用指南

由于 Qoder IDE 中的 MCP 连接可能存在问题，我们提供了多种直接访问 RimWorld 知识库的方法。

🚀 方法 1：直接 Python 调用

最简单直接的方法：

# 直接查询
python direct_mcp_client.py -q "ThingDef是什么"

# 交互模式
python direct_mcp_client.py -i

# 查看帮助
python direct_mcp_client.py -h

优点：

• ✅ 最快速，无需额外依赖
• ✅ 支持交互模式
• ✅ 直接在命令行使用

🛠️ 方法 2：命令行工具

专业的命令行查询工具：

# 基本查询
python rimworld_query.py "ThingDef的定义"

# 保存结果到文件
python rimworld_query.py "Building类的方法" --output building_info.txt

# 显示原始结果（不格式化）
python rimworld_query.py "Pawn类" --raw

# 查看示例
python rimworld_query.py --list-examples

优点：

• ✅ 结果可保存到文件
• ✅ 支持原始输出格式
• ✅ 内置查询示例

📝 常用查询示例

# 查询类定义
"ThingDef的定义和用法"
"Building类有哪些方法"
"Pawn类的构造函数"

# 查询特定方法
"GenConstruct.CanPlaceBlueprintAt 方法"
"Building_Door 的开关逻辑"
"CompPower 的电力管理"

# 查询XML相关
"XML中的defName规则"
"如何定义新的ThingDef"
"建筑物的XML结构"

🔧 故障排除

如果出现导入错误：

# 确保在正确的目录
cd "C:\Steam\steamapps\common\RimWorld\Mods\3516260226\MCP"

# 检查 Python 环境
python -c "import mcp; print('MCP SDK 正常')"

如果查询结果为空：

• 尝试使用更具体的关键词
• 检查关键词拼写
• 使用英文类名或方法名

如果 Web 服务器无法启动：

• 检查端口是否被占用
• 尝试使用不同的端口号
• 确保没有其他程序占用该端口

💡 推荐使用场景

• 快速查询: 使用方法 1 (direct_mcp_client.py)
• 批量处理: 使用方法 2 (rimworld_query.py)
• 团队共享: 使用方法 3 (web_api_server.py)
• 集成开发: 使用 Web API 接口

🎯 性能优化

所有方法都已经过优化：

• 向量化处理限制在 10 个文件以内
• API 调用超时设置为 12-15 秒
• 支持本地缓存加速重复查询

现在您可以完全绕过 Qoder IDE，直接使用 RimWorld 知识库了！