chore: 重命名 Tools/godot-mcp-pro-v1.15.1 → Tools/godot-mcp-pro,更新 .mcp.json
- 去掉版本号后缀,路径更稳定(后续更新工具不必再改 .mcp.json) - .mcp.json 指向新路径 server/build/index.js - server 依赖已 npm install 就绪;node_modules 由 .gitignore 忽略,未入库 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,73 @@
|
||||
# Installation Guide
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Godot 4.3+ (tested with 4.6)
|
||||
- Node.js 18+
|
||||
- An MCP-compatible AI client (Claude Code, Claude Desktop, etc.)
|
||||
|
||||
## Step 1: Godot Plugin
|
||||
|
||||
1. Copy the `addons/godot_mcp/` folder into your Godot project
|
||||
2. Open Project → Project Settings → Plugins
|
||||
3. Find "Godot MCP Pro" and click Enable
|
||||
4. You should see "MCP Server" appear in the bottom panel
|
||||
5. The status should show "Waiting for connection..."
|
||||
|
||||
## Step 2: Node.js Server
|
||||
|
||||
```bash
|
||||
cd server
|
||||
npm install
|
||||
npm run build
|
||||
```
|
||||
|
||||
This creates the compiled server in `server/build/`.
|
||||
|
||||
## Step 3: MCP Client Configuration
|
||||
|
||||
### Claude Code (.mcp.json)
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"godot-mcp-pro": {
|
||||
"command": "node",
|
||||
"args": ["/absolute/path/to/godot-mcp-pro/server/build/index.js"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Custom Port
|
||||
|
||||
Set the `GODOT_MCP_PORT` environment variable (default: 6505):
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"godot-mcp-pro": {
|
||||
"command": "node",
|
||||
"args": ["/absolute/path/to/server/build/index.js"],
|
||||
"env": { "GODOT_MCP_PORT": "6510" }
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Also update the port in `plugin.gd` (line 3: `const PORT := 6505`).
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Plugin doesn't appear
|
||||
- Make sure the `addons/godot_mcp/` directory is inside your Godot project
|
||||
- Check that `plugin.cfg` exists in the directory
|
||||
|
||||
### Connection fails
|
||||
- Verify the Godot editor is running with the plugin enabled
|
||||
- Check the bottom panel "MCP Server" tab for status
|
||||
- Ensure no firewall is blocking localhost port 6505
|
||||
|
||||
### Tools timeout
|
||||
- Commands have a 30-second timeout
|
||||
- Large operations (full filesystem scan) may need the `max_depth` parameter
|
||||
Reference in New Issue
Block a user