1. 服务概述一句话简介通过自然对话与LLM构建持久知识库将所有内容保存在本地Markdown文件中服务名称Basic Memory版本号最新版本开发者/提供方basicmachines-co协议类型MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点读写笔记创建、更新和检索带有标签和文件夹的markdown笔记删除笔记按标题或永久链接删除笔记搜索使用布尔运算符和过滤器执行高级搜索构建上下文使用memory:// URI和自然语言时间框架探索相关主题最近活动跟踪知识库中的更新生成可视化创建Obsidian canvas文件来可视化连接项目信息访问当前项目的统计信息读取原始内容按路径或永久链接访问文件内容3. 使用场景描述该服务适合在什么情况下使用构建持久知识库让AI助手记住之前的对话内容与LLM进行自然对话并自动保存知识到本地Markdown文件使用Obsidian管理和可视化知识库在对话过程中创建结构化笔记导航和探索知识图谱发现知识之间的关联导入ChatGPT对话历史到知识库4. 接入方式4.1 服务端点Basic Memory是一个本地MCP服务器通过MCP协议与Claude Desktop等客户端通信。所有数据存储在本地Markdown文件中默认目录为~/basic-memory。4.2 认证与权限基础功能无需认证所有数据存储在本地。可选的云功能需要订阅验证支持云同步和云存储挂载。4.3 数据格式使用Markdown文件格式存储知识包含Frontmatter标题、类型、永久链接、标签等元数据Observations使用- [category] content #tag (context)格式记录事实Relations使用- relation_type [[WikiLink]] (context)格式建立关联4.4 服务器配置在MCP客户端配置中添加服务{ mcpServers: { basic-memory: { command: uvx, args: [basic-memory, mcp] } } }5. 接口定义5.1 内容管理工具工具名称参数描述write_notetitle, content, folder, tags创建或更新笔记read_noteidentifier, page, page_size按标题或永久链接读取笔记read_contentpath读取原始文件内容文本、图像、二进制view_noteidentifier以格式化方式查看笔记edit_noteidentifier, operation, content增量编辑笔记move_noteidentifier, destination_path移动笔记并保持数据库一致性delete_noteidentifier从知识库中删除笔记5.2 知识图谱导航工具工具名称参数描述build_contexturl, depth, timeframe通过memory:// URL导航知识图谱recent_activitytype, depth, timeframe查找最近更新的信息list_directorydir_name, depth浏览目录内容并过滤5.3 搜索与发现工具工具名称参数描述searchquery, page, page_size在知识库中搜索5.4 项目管理工具工具名称参数描述list_memory_projects无列出所有可用项目create_memory_projectproject_name, project_path创建新项目get_current_project无显示当前项目统计信息sync_status无检查同步状态5.5 可视化工具工具名称参数描述canvasnodes, edges, title, folder生成知识可视化6. 快速开始6.1 环境要求Python环境uv包管理器推荐Claude Desktop或VS Code支持MCP协议的客户端6.2 示例代码安装Basic Memory# 使用uv安装推荐 uv tool install basic-memory配置Claude Desktop编辑配置文件~/Library/Application Support/Claude/claude_desktop_config.json{ mcpServers: { basic-memory: { command: uvx, args: [basic-memory, mcp] } } }同步知识库# 一次性同步本地知识更新 basic-memory sync # 运行实时同步进程推荐 basic-memory sync --watch使用示例# 在Claude Desktop中你可以 # - 创建笔记Create a note about coffee brewing methods # - 读取笔记What do I know about pour over coffee? # - 搜索Find information about Ethiopian beans7. 注意事项本地存储所有知识都存储在本地Markdown文件中确保数据隐私和安全实时同步建议运行basic-memory sync --watch保持文件和数据库同步多项目支持可以通过--project参数管理多个知识库项目Obsidian集成可以使用Obsidian查看和编辑Basic Memory创建的Markdown文件云功能云同步和云存储需要订阅但基础功能完全免费使用数据格式使用标准Markdown格式支持WikiLink链接和语义标记许可证AGPL-3.0开源协议相关资源官方网站Basic Machines | AI Tools for Local-First Knowledge文档https://memory.basicmachines.coGitHubhttps://github.com/basicmachines-co/basic-memory