RimWorld游戏API服务

一个将RimWorld游戏REST API端点暴露为MCP工具和资源的Python服务器。

  • by M4x28
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 M4x28/RimAPI_MCP_Server

使用说明

# RimAPI MCP服务器

Python MCP服务器,将RimWorld REST API(RIMAPI)端点公开为MCP工具和资源。

需求

  • Python 3.10+
  • mcp>=1.2.0

游戏先决条件

为了使此MCP服务器正常工作,必须在RimWorld中安装并启用RIMAPI mod,并且必须加载游戏保存(正在运行的游戏会话)。

安装(可选)

如果您只需要运行脚本,请安装 mcp:

python -m venv .venv
.\.venv\Scripts\python -m pip install mcp>=1.2.0

配置(ENV)

  • RIMAPI_BASE_URL (默认值 http://localhost:8765)

运行(stdio)

$env:RIMAPI_BASE_URL = 'http://localhost:8765'
.\.venv\Scripts\python src\mcp_server.py

注:与 stdio 传输时,MCP客户端必须启动服务器进程。如果您在没有客户端的情况下手动运行它,它可能会在stdin关闭时立即退出。

客户端设置(stdio)

生成stdio服务器的MCP客户端的通用示例:

MCPServerStdio(
    name="rimapi-mcp",
    params={
        "command": r"c:\\Projects\\RimAPI_MCP_Server\\.venv\\Scripts\\python",
        "args": [r"c:\\Projects\\RimAPI_MCP_Server\\src\\mcp_server.py"],
        "cwd": r"c:\\Projects\\RimAPI_MCP_Server",
        "env": {
            "MCP_TRANSPORT": "stdio",
            "RIMAPI_BASE_URL": "http://localhost:8765",
        },
    },
)

如果客户端不接受绝对路径,则设置 cwd 和使用 args: ["src/mcp_server.py"].

致谢

感谢IlyaChichkov的RIMAPI mod使这个MCP服务器成为可能: https://github.com/IlyaChichkov/RIMAPI