se-mcp-for-plugin-dev

🚀 太空工程师插件开发MCP服务器

这是一个为“AI”编码代理提供支持的MCP服务器，能为插件开发提供实用功能。目前，该工具仅支持《太空工程师1》。

若需支持，请加入SE Mods Discord社区。

请考虑在Patreon上支持我的工作，或通过PayPal进行一次性捐赠。

感谢支持，祝您使用愉快！

🚀 快速开始

🔍 前提条件

• 通过Steam安装**《太空工程师》**
• 安装 .NET 8.0 SDK，Windows x64
• 安装 ILSpy 版本 8.2.0.7535 - 通过运行 SetupILSpy.bat 进行安装
• 安装 Python 3.12 或更高版本
• 安装 Git
• 至少有1GB的可用磁盘空间

确保以下可执行文件已添加到系统的 PATH 环境变量中：

• ilspycmd
• python
• git

定义环境变量 SPACE_ENGINEERS_ROOT：

• 通常的值为：C:\Program Files (x86)\Steam\steamapps\common\SpaceEngineers
• 若你将游戏安装在自定义路径，请使用该自定义路径。

🛠️ 准备工作

运行 Prepare.bat，该脚本大约需要10 - 20分钟来完全反编译游戏并安装 code-index-mcp。

脚本执行结束时应输出 DONE。

💻 在IDE中连接到编码代理

以下设置已被验证可以正常工作：

• VSCode：请安装微软官方版本，而非开源的VSCodium，因为后者缺少我们所需的一些AI API集成。
• Copilot插件：按照其安装说明进行操作。
• Cline插件：按照其安装说明进行操作。

在Cline的设置中，选择API提供方为“VS Code LM API”

确保你在右侧面板中打开了Cline和Chat标签页。

在Cline标签页中，点击MCP服务器按钮（顶部带有“3个服务器堆叠”图标）。选择“配置”标签页，然后点击“配置MCP服务器”按钮。将 Prepare.bat 生成的 mcp.json 文件中的 space-engineers-code-index 条目复制到你编辑器的MCP服务器列表中。

你的IDE将根据需要自动启动一个实例并管理其生命周期。由于反编译后的游戏代码量很大，索引过程可能会导致一些延迟。但如果你在编码中使用任何AI工具，这些时间和精力的投入都是非常值得的。

💡 最佳实践

• 在计划模式下，选择GPT - 5；在执行模式下，选择GTP - 5 - mini。你也可以根据自己的意愿或可用情况选择其他模型。
• 如果你经常使用该工具，那么购买每年100美元的Copilot Pro订阅（截至2025年11月）是很值得的。
• 你可以在VSCode中完成整个开发过程，或者在与常规IDE（如VS、Rider）相同的仓库中打开VSCode。在常规IDE中进行手动更改、构建和调试，同时在VSCode中并行运行编码代理。对我来说，后一种设置效果最佳，因为它允许在测试/调试的同时轻松进行规划，因为这两个过程不需要更改任何代码。

🌐 通过HTTP传输提供MCP服务

MCP可以通过HTTP传输提供服务，这允许从运行在另一台机器或服务器上的编码代理连接到它。

准备脚本将创建一个 HttpServer.bat 批处理文件，你可以使用它通过HTTP运行MCP服务器。

使用你的编码代理（MCP客户端）连接到 127.0.0.1:8000。

测试：http://127.0.0.1:8000/sse/ - 页面应显示 event: endpoint

SSE（服务器发送事件）是一种允许服务器通过HTTP连接向客户端自动发送更新的技术。

如果你想将外部主机或服务器（如GitHub Copilot）连接到这个MCP服务器，你需要将 127.0.0.1:8000 转发到一个公开可见的端点，理想情况下是将其封装为HTTPS（反向代理）。

为了使此功能正常工作，你公开可见的主机名（或域名）需要在GitHub Copilot设置中列入白名单。

• TODO: 转发操作指南：SSH端口转发、反向代理设置、在路由器上开放端口等。
• TODO: 使用秘密URL路径进行身份验证。
• TODO: 使用Bearer令牌进行身份验证。