Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client