Goldie MCP

MCP数据服务

提供方 srfrog

数据服务 未标注 会话登录 社区 / 第三方 Claude DesktopClaude

Goldie是一个本地运行的多代理记忆服务器,通过共享的SQLite向量索引存储和管理多代理(如Claude、Codex等)的记忆。

一句话选型结论

按资料字段整理

Goldie MCP 属于数据服务类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 9 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量9暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

记忆管理Go本地部署SQLite向量索引多代理系统本地运行

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 9 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 9 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Goldie MCP当前 9 未标注 未标注 无 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方srfrog上游标注的维护方 srfrog
分类数据服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

17.7 KB
来自项目仓库与上游目录的原文,未做删改

戈尔迪🐕

用Go编写的多代理内存MCP服务器,在您的机器上本地运行。戈尔迪商店打字,命名 回忆 在共享的SQLite向量索引中,这样多个代理(Claude、Codex等)就可以 remember, recall, update_memory,以及 forget 从一个池中--替换每个项目 MEMORY.md 所有文件都可以共享后端。

特性

  • 打字记忆:每个内存都有一个类型(user, feedback, project, reference, opinion, idea, todo, reminder),唯一名称、可选描述、正文、代理和源
  • 共享池:Scope是一个SQLite文件——将任意数量的代理指向同一数据库,它们共享内存
  • 语义回忆:在块嵌入上过滤KNN;recall返回父内存加上匹配的摘录
  • 多个嵌入后端:MiniLM(通过ONNX运行时本地)或Ollama(任何嵌入模型)
  • 文件摄取: index_file / index_directory 将文件导入为 reference 按绝对路径命名的内存(校验和门控追加)
  • 异步作业队列:长期运行的索引操作在后台运行,并具有进度跟踪功能

需求

MiniLM后端(需要ONNX运行时)```bash

macOS

brew install onnxruntime

Ubuntu/Debian

sudo apt install libonnxruntime-dev

Fedora/RHEL

sudo dnf install onnxruntime-devel

Arch Linux

sudo pacman -S onnxruntime


### Ollama后端

如果你想使用Ollama而不是MiniLM,你只需要安装Ollama:```bash
# macOS
brew install ollama

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

# Pull an embedding model
ollama pull nomic-embed-text

如果您只打算使用Ollama,请跳过下面的ONNX Runtime安装。

安装

发布(推荐)

从下载预构建的二进制文件 发布页面:

平台 二进制
macOS(苹果硅) goldie-mcp-darwin-arm64
macOS(英特尔) goldie-mcp-darwin-amd64
Linux(x86_64) goldie-mcp-linux-amd64
Linux(ARM64) goldie-mcp-linux-arm64
# Example for macOS Apple Silicon
curl -LO https://github.com/srfrog/goldie-mcp/releases/latest/download/goldie-mcp-darwin-arm64
chmod +x goldie-mcp-darwin-arm64
mv goldie-mcp-darwin-arm64 ~/bin/goldie-mcp

发布的二进制文件是专门为macOS编写的,并包含MiniLM模型,因此不需要额外下载。

从源代码构建

需要Go 1.22+、启用CGO和Git LFS(模型文件与LFS一起存储):```bash
git lfs install # if not already configured
git clone https://github.com/srfrog/goldie-mcp
cd goldie-mcp
make build


## 配置

### 命令行标志

|标志|描述|默认值|
|------|-------------|---------|
| `-b` |嵌入后端: `minilm` 或 `ollama` | `minilm` |
| `-l` |日志文件路径|stderr|

### 环境变量

|变量|描述|默认值|
|----------|-------------|---------|
| `GOLDIE_DB_PATH` |SQLite数据库的路径| `~/.local/share/goldie/index.db` |
| `GOLDIE_JOURNAL_MODE` |SQLite日志模式PRAGMA。默认情况下,云同步存储是安全的。集 `WAL` 仅用于本地数据库,以在写入并发期间启用读取| `DELETE` |
| `ONNXRUNTIME_LIB_PATH` |libonnxruntime共享库的路径(仅限MiniLM)|自动检测到|
| `OLLAMA_HOST` |Ollama API基本URL(仅限Ollama)| `http://localhost:11434` |
| `OLLAMA_EMBED_MODEL` |Ollama嵌入模型名称(仅限Ollama)| `nomic-embed-text` |
| `OLLAMA_EMBED_DIMENSIONS` |自定义型号尺寸(仅限Ollama)|自动检测已知型号|

### 支持的Olama嵌入模型

|型号|尺寸|备注|
|-------|------------|-------|
| `nomic-embed-text` |768 |默认值,通用性良好|
| `mxbai-embed-large` |1024 |质量更高,速度更慢|
| `all-minilm` |384 |与MiniLM后端相同|

对于其他型号,设置 `OLLAMA_EMBED_DIMENSIONS` 模型的输出维度。

## 使用Claude代码

### 使用MiniLM(默认)```bash
claude mcp add -s user -e GOLDIE_DB_PATH=~/.local/share/goldie/index.db goldie /path/to/goldie-mcp

注: ONNXRUNTIME_LIB_PATH 如果库位于标准位置,则是可选的。

与Ollama```bash

claude mcp add -s user -e GOLDIE_DB_PATH=~/.local/share/goldie/index.db goldie /path/to/goldie-mcp -- -b ollama


注意:确保Ollama正在跑步(`ollama serve`)在启动Claude Code之前。

## 使用Claude Desktop

添加到您的Claude Desktop配置(`claude_desktop_config.json`):

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`

### 使用MiniLM(默认)```json
{
"mcpServers": {
"goldie": {
"type": "stdio",
"command": "/path/to/goldie-mcp",
"env": {
"GOLDIE_DB_PATH": "/home/user/.local/share/goldie/index.db"
}
}
}
}

与Ollama```json

{
"mcpServers": {
"goldie": {
"type": "stdio",
"command": "/path/to/goldie-mcp",
"args": ["-b", "ollama"],
"env": {
"GOLDIE_DB_PATH": "/home/user/.local/share/goldie/index.db",
"OLLAMA_EMBED_MODEL": "nomic-embed-text"
}
}
}
}


## 使用OpenAI Codex

添加到您的Codex配置(`~/.codex/config.toml`):

### 使用MiniLM(默认)```toml
[mcp_servers.goldie]
command = "/path/to/goldie-mcp"

[mcp_servers.goldie.env]
GOLDIE_DB_PATH = "/home/user/.local/share/goldie/index.db"
ONNXRUNTIME_LIB_PATH = "/path/to/libonnxruntime.so"

注: ONNXRUNTIME_LIB_PATH 如果库位于标准位置,则是可选的。Homebrew将把它安装到 /opt/homebrew/lib/libonnxruntime.dylib 在macOS上。在Linux中,使用 ldconfig -p | grep onnxruntime.

与Ollama```toml

[mcp_servers.goldie]
command = "/path/to/goldie-mcp"
args = ["-b", "ollama"]

[mcp_servers.goldie.env]
GOLDIE_DB_PATH = "/home/user/.local/share/goldie/index.db"
OLLAMA_EMBED_MODEL = "nomic-embed-text"


## 内存模型

戈尔迪指数是一个持平的指数池 **回忆**每个存储器都有这些字段:

|字段|必填|备注|
|---------------|----------|-----------------------------------------------------------------------|
| `name` |yes |数据库中唯一。名称冲突→ `remember` 失败(见下文)|
| `type` |是|以下之一: `user`, `feedback`, `project`, `reference`, `opinion`, `idea`, `todo`, `reminder` |
| `body` |是的|全部内容。隐藏在引擎盖下,用于嵌入级别回忆|
| `description` |否|单行摘要;参与语义回忆|
| `agent` |no |创建内存的代理(例如。 `claude-opus-4-7`, `codex`)   |
| `source` |no |内存来源(文件路径、编辑器、URL)|

**分享。** “Scope”只是SQLite文件。多个代理指向同一个 `GOLDIE_DB_PATH` 共享相同的内存池——没有每个代理的隔离。使用 `agent` 和 `source` 在读取/删除时进行筛选。

**命名和冲突。** 名称必须是唯一的。 `remember` 是严格的,没有扰乱。如果两个代理试图创建相同的名称,则第二个代理会出错,预计会 `recall` 现有的内存和调用 `update_memory` (或选择其他名称)。

**更新语义。** 名称是不可变的。 `update_memory` 接受类型/描述/主体/源/代理的补丁;更改为 `description` 或 `body` 重新嵌入块。

**文件摄取。** `index_file` / `index_directory` 是 *一* 不扰乱销售规则的例外。它们将文件作为记忆导入 `type=reference`,与 `name = source = `。当SHA-256校验和匹配时,对同一路径重新索引会跳过,当不匹配时,会替换正文。

## 可用工具

### 记住

创造新的记忆。如果失败 `name` 已在使用中——请回忆并使用 `update_memory` 相反。

**参数:**

- `name` (必填):唯一标识符(例如。, `feedback_testing`)
- `type` (必填):其中之一 `user`, `feedback`, `project`, `reference`, `opinion`, `idea`, `todo`, `reminder`
- `body` (必填):完整内容
- `description` (可选):单行摘要
- `agent` (可选):创建内存的代理
- `source` (可选):内存生成的位置

### 召回

语义回忆胜过记忆。返回最相关的记忆以及匹配的块摘录。按类型、代理或来源筛选以缩小范围。

**参数:**

- `query` (必填):主题或问题
- `limit` (可选):最大结果(默认5,最大20)
- `type`, `agent`, `source` (可选):过滤器

### update_memory

按id或名称更新现有内存。正文/描述更改重新嵌入。

**参数:**

- `id_or_name` (必填)
- `type`, `description`, `body`, `source`, `agent` (可选补丁)

### 忘记

删除记忆。需要至少一个过滤器或查询——拒绝擦除所有内容。通过查询,(可选)筛选器中的顶级匹配项将被删除。

**参数:**

- `name`, `type`, `agent`, `source` (可选过滤器)
- `query` (可选):语义匹配
- `limit` (可选):给定查询时的最大匹配数(默认值5)

### list_memories

列出与筛选器匹配的内存,最新的优先。仅返回元数据(无正文)。

**参数:**

- `type`, `agent`, `source` (可选过滤器)
- `limit` (可选)

### count_memories

统计与过滤器匹配的内存。

### 索引文件

将文件导入为 `reference` 记忆。记忆的 `name` 是绝对路径;当校验和更改时,重新索引更新。

**参数:**

- `path` (必填)

### 索引目录

将目录中的每个匹配文件导入为 `reference` 回忆。

**参数:**

- `directory` (必填)
- `pattern` (可选,默认 `*`)
- `recursive` (可选,默认 `false`)

### job_status、list_jobs、clear_queue

管理异步索引队列。 `index_file` 和 `index_directory` 将后台完成的作业排队;使用 `job_status` 检查进度。

## 跳过模式

在索引目录时,Goldie会自动跳过某些文件和目录,以避免索引无关的内容。

### 默认跳过模式

如果没有 `.goldieskip` 文件存在于被索引的目录中,Goldie使用以下默认值:

|图案|描述|
|---------|-------------|
| `.[!.]*` |所有点文件和点目录(`.git/`, `.env`, `.vscode/`等等)|
| `node_modules/` |Node.js依赖关系|
| `vendor/` |Go/PHP供应商目录|
| `__pycache__/` |Python字节码缓存|
| `AGENTS.md` |AI代理配置|
| `CLAUDE.md` |克劳德配置|

### 自定义跳过模式

创建一个 `.goldieskip` 目录中的文件以定义自定义模式。这 **替换** 完全违约。格式与 `.gitignore`,具有相同的模式语法。```
# .goldieskip example
# Lines starting with # are comments

# Skip all dotfiles/dotdirs
.[!.]*

# Skip dependencies
node_modules/
vendor/
.venv/

# Skip build outputs
dist/
build/
target/

# Skip specific files
*.log
*.tmp
secrets.json

模式语法:

  • * 匹配任何字符序列
  • ? 匹配任何单个字符
  • [abc] 匹配集合中的任何字符
  • [!abc] 匹配不在集合中的任何字符
  • 以结尾的模式 / 匹配目录

示例提示

您可以使用Claude Code、Claude Desktop或Codex的示例提示:

记住```

Remember as a feedback memory named "feedback_testing": don't mock the database in integration tests — we got burned last quarter by mock/prod divergence.

Remember this user fact named "user_role": senior Go engineer, ten years of experience, currently learning React.

Save an opinion named "ui_dark_mode": dark mode is easier on the eyes for long sessions.


### 召回```
Recall what you know about database testing
``````
Recall feedback memories about pull request size
``````
What memories do I have about the API design?

update_memory```

Update memory "feedback_testing": new body is "use a real Postgres in CI; the staging DB is reset nightly".


### 忘记```
Forget all opinion memories from agent "claude-opus-4-7"
``````
Forget memories matching "old API design notes"

list_memories/count_memories```

List my feedback memories

How many memories has agent "codex" written?
```

### index_file/index_directory```
Index the file ~/project/README.md

Index all *.md files in ~/docs recursively


## 代理配置

代理商默认情况下不会去找goldie——Claude Code有自己的 `/memory`,Codex有自己的上下文处理。回购提供了两个固执己见的模板,将它们推向共享池。两者都很短,可以按原样安全地进入。

### 克劳德代码

复制 `templates/CLAUDE.md` 到 `~/.claude/CLAUDE.md` (它被加载到每个Claude Code会话中):```bash
cp templates/CLAUDE.md ~/.claude/CLAUDE.md

对于项目范围的行为,请将其复制到 /CLAUDE.md.

Codex(命令行界面/应用程序)

复制 templates/AGENTS.md 到 ~/.codex/AGENTS.md (食品法典载荷 AGENTS.override.md 和 AGENTS.md 从 $CODEX_HOME,默认值 ~/.codex):```bash
cp templates/AGENTS.md ~/.codex/AGENTS.md


作为安全带和吊带的措施,请在 `~/.codex/config.toml` 因此,即使Codex未加载AGENTS.md,该规则也会在会话开始时触发:```toml
developer_instructions = """
At session start, read and obey ~/.codex/AGENTS.md when it exists.
For persistent memory operations, prefer Goldie over local memory when the Goldie MCP server is connected.
"""

定制

这两个模板都是起点。将它们编辑为:

  • 限制内存 type代理应该创建什么
  • 为添加特定于项目的命名约定 name (例如。 _)
  • 覆盖默认值 agent 价值
  • 收紧或放松“何时不使用黄金”规则

跨机器共享一个数据库

Goldie的“作用域”是SQLite文件,因此跨机器(iCloud、Dropbox、Syncthing)同步数据库文件可以在不运行服务器的情况下为您提供跟我走内存。默认日记模式(DELETE)在云同步下已经可以安全使用了——只有一个 .db 文件存在,没有WAL/SHM sidecar出现故障。一个警告:

不要同时从两台机器上写字。 云同步不是协调层。如果两台机器在断开连接时写入,同步客户端会选择一个赢家,另一方的写入将丢失(或创建冲突副本)。工作流程:在切换机器之前退出任何goldie会话,让同步解决,启动新机器。

对于真正的多写入器多机设置,请在服务器上运行goldie并通过Tailscale连接,或使用 文学流 将WAL更改流式传输到S3/B2。

选择仅适用于本地DB的WAL

如果您的数据库位于本地磁盘上(没有云同步),并且您希望在多代理负载繁重的情况下在写并发期间进行读取,请设置 GOLDIE_JOURNAL_MODE=WAL。对于典型的内存存储工作负载,性能差异可以忽略不计,但选项是存在的。

替换每个项目的内存.md

Goldie旨在取代每个项目 MEMORY.md Claude Code等代理在磁盘上创建的文件。让每个代理都指向同一个目标 GOLDIE_DB_PATH,指示他们使用 remember / recall / update_memory / forget 而不是基于文件的内存,你会得到:

  • Claude(任何会话、任何项目)、Codex和任何其他MCP感知代理共享一个池
  • 语义召回而不是文件全局搜索
  • 通过 agent 字段,可通过以下方式查询 recall/forget 过滤器
  • 过滤清理(例如“忘记所有 feedback 来自代理X的记忆”)

对现有成绩单进行索引

您还可以将旧的Claude Code对话记录批量导入为 reference 记忆使他们参与回忆:```
Index all *.md files in ~/.claude/projects recursively


然后问:```
Recall what I know about authentication bugs
``````
What memories do I have about Docker?

故障排除

macOS:二进制立即终止(信号9)

在macOS上复制二进制文件时,Gatekeeper可能会添加隔离属性(com.apple.provenance)这会导致双星在发射时被杀死。使用 make install DEST= 它直接构建到目标并对二进制文件进行代码签名以避免此问题。

食品法典委员会不召回

  • Codex中的MCP支持是实验性的,需要更多的引导才能正常工作。索引内容后,尝试 recall 并检查它是否使用 goldie.recall() 函数,表示它正在使用MCP后端。
  • Codex有时不信任回忆中的内容,也不会将其添加到上下文中,需要重复调用 goldie.search_index()你可以试试 recall and consolidate 推送更新。

建筑```

goldie-mcp/
├── main.go # MCP server setup and tool handlers
├── internal/
│ ├── embedder/ # Embedding interface and backends
│ │ ├── minilm/ # MiniLM backend (ONNX Runtime)
│ │ └── ollama/ # Ollama backend (API client)
│ ├── goldie/ # Memory operations (Remember/Recall/Update/Forget)
│ │ ├── goldie.go # Core, file ingestion, chunking
│ │ └── memory.go # Type whitelist + memory CRUD
│ ├── store/ # SQLite memory + chunk + vec storage
│ │ ├── store.go # Connection, jobs
│ │ └── memory.go # Memory schema and queries
│ └── queue/ # Async job processing
├── go.mod
└── Makefile
```

模式

三个SQLite表组成了内存索引:

  • memories --每个内存一行: id, name UNIQUE, type, description, body, agent, source, checksum, created_at, updated_at
  • memory_chunks --为了嵌入粒度,主体被分割成重叠的块: id, memory_id, chunk_index, content
  • memories_vec — vec0 基于块嵌入的虚拟表,在回忆时连接回记忆

Recall对块进行KNN,然后对不同的记忆进行重复数据删除,为每个记忆返回最匹配的摘录。

嵌入后端

MiniLM后端(-b minilm)

用途 全迷你LM-L6-v2 通过ONNX运行时:

  • 384维嵌入
  • 针对语义相似性进行了优化
  • 在本地运行,模型嵌入二进制文件中

Ollama后端(-b ollama)

使用Ollama的嵌入API与您选择的模型:

  • nomic-embed-text (768维)-默认,质量和速度的良好平衡
  • mxbai-embed-large (1024维)-更高质量的嵌入
  • all-minilm (384维度)-与MiniLM后端型号相同
  • 任何其他Olama嵌入模型(集 OLLAMA_EMBED_DIMENSIONS)

注: 不同的嵌入模型产生不同的维度向量。用一个后端/模型索引的内存不能用另一个具有不同维度的后端/模型调用。切换时使用单独的数据库或重新索引。

许可证

麻省理工学院

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Goldie MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Goldie MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Goldie MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Goldie MCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Goldie MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Goldie MCP 能提供哪些能力?

资料显示约 9 个工具;能力标签包括 记忆管理、本地运行、Go、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。