内容
# 内存 MCP
个人外部大脑 MCP 服务器 - 一个用于通过 GitHub 同步模板、标准和知识的无状态 MCP 服务器。
## 功能
- **零延迟读取**：内存缓存，实现即时访问模板和标准
- **非阻塞写入**：异步 GitHub 同步，带有本地队列，保证韧性
- **自动分类**：文件按类别组织（模板、标准、知识等）
- **全文搜索**：跨文件路径和内容搜索
## 安装
### VS Code / Copilot
添加到您的 `~/.vscode/mcp.json` 或 VS Code 设置中：
```json
{
"servers": {
"memory-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "memory-mcp"],
"env": {
"MEMORY_MCP_REPO": "您的用户名/memory-mcp-storage",
"MEMORY_MCP_TOKEN": "ghp_您的令牌_在此"
}
}
}
}
```
### Claude Desktop
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"memory-mcp": {
"command": "npx",
"args": ["-y", "memory-mcp"],
"env": {
"MEMORY_MCP_REPO": "您的用户名/memory-mcp-storage",
"MEMORY_MCP_TOKEN": "ghp_您的令牌_在此"
}
}
}
}
```
## 配置
| 变量 | 是否必需 | 描述 |
|----------|----------|-------------|
| `MEMORY_MCP_REPO` | 是 | GitHub 仓库，格式为 `所有者/仓库` |
| `MEMORY_MCP_TOKEN` | 是 | GitHub 个人访问令牌，作用域为 `仓库` |
## 工具
### `list_knowledge`
列出按类别组织的所有可用内存文件。
### `read_memory`
读取特定内存文件的内容。
```json
{ "path": "templates/user-story.md" }
```
### `save_memory`
创建或更新内存文件。类别文件夹会自动创建。
```json
{ "category": "templates", "name": "user-story.md", "content": "..." }
```
### `delete_memory`
删除内存文件。
```json
{ "path": "templates/old-template.md" }
```
### `search_memory`
按关键词搜索所有内存文件。
```json
{ "query": "graphql 错误" }
```
## 存储仓库结构
使用以下结构创建私有 GitHub 仓库（例如，`memory-mcp-storage`）：
```
/
├── index.json # 自动生成的清单
├── templates/ # Markdown 模板
│ ├── user-story.md
│ └── pull-request.md
├── standards/ # 技术规则（YAML/JSON）
│ ├── typescript.yaml
│ └── graphql.yaml
└── knowledge/ # 长篇上下文
└── architecture.md
```
## 工作原理
1. **启动**：从 GitHub 获取所有文件，填充内存缓存
2. **读取**：缓存优先（即时），在未命中时回退到 GitHub API
3. **写入**：立即更新缓存，返回给代理，异步同步 GitHub
4. **失败**：失败的写入队列到 `~/.memory-mcp-queue.json`，在下一次操作时重试
## 开发
```bash
# 安装依赖
npm install
# 构建
npm run build
# 监视模式
npm run dev
```
## 许可证
MIT
