AI导哈

知识同步服务器

一个无状态的MCP服务器，用于通过GitHub同步模板、标准和知识，提供零延迟读取、非阻塞写入、自动分类和全文搜索功能。

  • by clayton-duarte
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 clayton-duarte/memory-mcp

使用说明

存储器mcp

个人外部大脑MCP服务器-一个无状态的MCP服务器，用于通过GitHub同步模板、标准和知识。

特性

  • 零延迟读取：内存缓存，用于即时访问模板和标准
  • 非阻塞写入：异步GitHub与本地队列同步以增强弹性
  • 自动分类：按类别（模板、标准、知识等）组织的文件
  • 全文搜索：跨文件路径和内容搜索

安装

VS代码/副本

添加到您的 ~/.vscode/mcp.json 或VS代码设置：

{
  "servers": {
    "memory-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "memory-mcp"],
      "env": {
        "MEMORY_MCP_REPO": "your-username/memory-mcp-storage",
        "MEMORY_MCP_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

克劳德桌面版

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "memory-mcp": {
      "command": "npx",
      "args": ["-y", "memory-mcp"],
      "env": {
        "MEMORY_MCP_REPO": "your-username/memory-mcp-storage",
        "MEMORY_MCP_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

配置

变量 必填 描述
MEMORY_MCP_REPO 是 GitHub存储库位于 owner/repo 格式
MEMORY_MCP_TOKEN 是 GitHub个人访问令牌 repo 范围

工具

list_knowledge

按类别列出所有可用内存文件。

read_memory

读取特定内存文件的内容。

{ "path": "templates/user-story.md" }

save_memory

创建或更新内存文件。类别文件夹是自动创建的。

{ "category": "templates", "name": "user-story.md", "content": "..." }

delete_memory

删除内存文件。

{ "path": "templates/old-template.md" }

search_memory

按关键字搜索所有内存文件。

{ "query": "graphql error" }

存储库结构

创建私有GitHub存储库（例如。， memory-mcp-storage)采用这种结构：

/
├── index.json             # Auto-generated manifest
├── templates/             # Markdown templates
│   ├── user-story.md
│   └── pull-request.md
├── standards/             # Technical rules (YAML/JSON)
│   ├── typescript.yaml
│   └── graphql.yaml
└── knowledge/             # Long-form context
    └── architecture.md

运作原理

  1. 初创公司：从GitHub获取所有文件，填充内存缓存
  2. 阅读：Cache-first（即时），在未命中时返回到GitHub API
  3. 写入：立即更新缓存，返回代理，同步GitHub异步
  4. 失败：写入队列失败 ~/.memory-mcp-queue.json 并在下次操作时重试

发展

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

许可证

麻省理工学院

相关 MCP