使用说明

gd示波器

用于Godot项目的具有Ollama兼容端点的统一MCP服务器

通过MCP协议和Ollama兼容的API在单个端口上为AI助手提供对Godot项目的结构化访问。Ollama模型可进行语义搜索。

专为与Ai Assistant Hub协同工作而打造。艾助手中心

⚠️ 安全警告

✅ 运行于 仅限本地主机 (127.0.0.1)
✅ 打算给 单用户、本地开发
⚠️ 无需认证 -您计算机上的任何人都可以访问
⚠️ 外部工具在您的权限下执行 -仅使用受信任的工具
⚠️ 了解风险 -在路径沙盒中，AI仍然可以调用任何启用/可用的工具

安全使用：

仅限本地主机✓
仅限受信任的工具✓
显影机✓

不安全使用：

网络曝光✗
共享服务器✗
不受信任的工具✗
生产环境✗

关键见解

🎯 统一服务器体系结构 -单流程单端口（3333）
🔌 Ollama兼容端点 -适用于AI助手中心、VS代码扩展、Rider插件
🤖 自动工具调用 -面向Ollama客户的透明工具执行
📚 双协议支持 -用于Claude Desktop/Cursor+Ollama API的MCP协议

快速开始

1.安装先决条件

奥拉马：

# macOS
brew install ollama

# Linux
curl -fsSL https://ollama.com/install.sh | sh

# Windows
# Download from https://ollama.com/download

转到1.22+ （如果从源头建造）：

go version  # Check version

2.启动Olama

当地：

ollama serve

远程（ollama服务器）：

指向您的远程实例
配置 ollama_url 在mcp.json中
例子： "ollama_url": "http://192.168.1.100:11434"

3.拉模型

# Chat model (recommended for tool calling)
ollama pull qwen3 # Large
ollama pull qwen2.5-coder:14b # Best balance

# Embedding model (for semantic search)
ollama pull nomic-embed-text

验证：

ollama list

4.在Godot项目中安装

# Create addon directory in your Godot project
mkdir -p /path/to/your/godot/project/addons/gd-scope
cd /path/to/your/project/addons/gd-scope

5.构建gd范围


# Install dependencies
go mod tidy 
# Build
go build -o gd-scope .

特性

核心工具（始终可用）

工具	它做什么
`read_file`	读取任何项目文件
`list_files`	递归列出文件
`project_info`	解析项目.godot
`list_scenes`	查找所有.tscn文件
`read_scene`	解析场景层次结构
`list_scripts`	查找所有.gd/.cs文件
`docs_versions`	列出Godot文档版本
`docs_list`	列出版本的页面
`docs_get`	获取文档页面
`docs_search`	全文文档搜索

语义搜索（需要Ollama+嵌入模型）

工具	它做什么
`index_project`	嵌入项目文件
`semantic_search`	自然语言搜索

自定义工具

添加您自己的工具：

Python/Rust/Node -JSON标准输入/标准输出
GDScript -完全Godot引擎API访问

配置参考

最小配置（自动检测项目根）：

{
  "ollama_url": "http://127.0.0.1:11434"
}

完整配置：

{
  "_comment_security": "Server binds to localhost only. Port configurable.",
  "addr": "127.0.0.1:3333",
  
  "_comment_ollama": "Can point to local or remote Ollama instance",
  "ollama_url": "http://127.0.0.1:11434",
  
  "project_root": ".",
  "docs_dir": "docs",
  "tools_dir": "tools",
  "external_timeout_seconds": 30,
  
  "godot_bin": "godot",
  "embed_model": "nomic-embed-text",
  "default_model": "qwen3"
}

远程Ollama设置

在Ollama主机（例如桌面）上：

export OLLAMA_HOST=0.0.0.0:11434
ollama serve

在gd作用域mcp.json中：

{
  "ollama_url": "http://192.168.1.100:11434"
}

可用端点

Ollama-兼容

POST /api/chat -使用自动工具调用聊天
POST /api/generate -单次完成（代理）
GET /api/tags -列出模型（代理）

MCP协议

GET /mcp/v1/tools -列出可用工具
POST /mcp/v1/tools/{name} -调用特定工具

健康

GET /health -服务器健康检查

文档

QUICKSTART.md -5分钟设置指南
AI-ASSISTANT-HUB.md -AI助手中心集成
OLLAMA-SETUP.md -Ollama安装和型号
工具创建.md -创建自定义工具
API参考文献.md -完整的API文件

需求

转到1.22+ （用于建筑）
奥拉玛 （用于LLM和嵌入）
戈多4.x （仅当使用GDScript工具时）
最小4-8GB VRAM （用于运行Olama车型）

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

学分

专为Godot社区打造
用途 MCP Go SDK
设计用于与 AI助手中心
Ollama与本地人工智能的集成