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与本地人工智能的集成