返回 MCP 目录
public公开dns本地运行

basic-memory

Basic Memory是一个通过自然对话与大型语言模型(LLM)交互构建持久知识的工具,使用Markdown文件本地存储数据,并实现MCP协议实现双向知识管理。

article

README

🚀 基本记忆

基本记忆是一款基于MCP(模型上下文协议)构建的桌面应用程序,它集成了Claude Desktop和VS Code,能有效增强人工智能驱动的研究与写作体验,让信息组织变得简单又高效。

🚀 快速开始

基本记忆集成了Claude Desktop和VS Code,为你带来便捷的信息组织体验。下面将为你介绍如何快速开启使用之旅。

✨ 主要特性

  • 实时同步:Claude桌面版可直接访问你的知识库
  • 多格式支持:支持Markdown、文本等文件类型
  • 标签系统:便于快速分类和检索内容
  • 版本控制:记录每次更新,方便回溯
  • 项目管理:支持创建独立的知识库

📦 安装指南

使用 VS Code

将以下配置添加到用户设置(JSON格式)中:

{
  "mcp": {
    "servers": {
      "basic-memory": {
        "command": "uvx",
        "args": ["basic-memory", "mcp"]
      }
    }
  }
}

或者在工作区的.vscode/mcp.json文件中添加:

{
  "servers": {
    "basic-memory": {
      "command": "uvx",
      "args": ["basic-memory", "mcp"]
    }
  }
}

配置 Claude Desktop

编辑Claude桌面配置文件(通常位于~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory",
        "mcp"
      ]
    }
  }
}

💻 使用示例

基础用法

  • 创建笔记:使用write_note函数记录想法
  • 查阅笔记:通过read_note按标题或 permalink 查看内容
  • 构建上下文:借助build_context函数导航知识图谱
  • 搜索笔记:利用search_notes在知识库中查找信息
  • 近期动态:使用recent_activity回顾过去的工作

高级用法

“创建一个关于我们架构决策的项目记录”
“查找关于JWT身份验证的信息”
“生成项目组件的知识图谱可视化”
“阅读我对身份验证系统的笔记”
“这周我工作了哪些内容?”

📚 详细文档

更多资料请参考官方文档,包括:

📄 许可证

AGPL - 3.0

欢迎贡献。查看贡献指南了解如何本地设置项目和提交PR。

星辰历史

由 Basic Machines 热心打造

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端