Obsidian MCP(模型上下文协议)
Obsidian MCP 是一款工具,允许您使用模型上下文协议 (MCP) 与 Obsidian Vault 进行交互。这使得 AI 助手能够通过标准化界面读取、写入和操作 Obsidian Vault 中的笔记。
先决条件
Node.js 18 或更高版本
安装并配置了本地 REST API 插件的 Obsidian
从本地 REST API 插件生成的 API 密钥
设置 MCP 服务器(例如 Claude 桌面应用程序)
克隆此存储库
安装依赖项:
npm install构建项目:
npm run build配置 Claude 桌面应用程序以使用此 MCP 服务器:
{ "mcpServers": { "Obsidian": { "command": "node", "args": ["/Users/<Your Own Path>/obsisian-mcp/build/index.js"], "env": { "apiKey": "<Your API Token>", "port": "27123", "host": "127.0.0.1" } } } }
发展
创建.env
并按照上面提到的配置“apiKey”、“port”和“host”。
可用工具
实施了以下工具:
readNote - 阅读特定注释的内容
{ "path": "path/to/note.md" }readActiveNote - 读取当前活动笔记的内容
{}listNotes - 递归列出整个 Vault 中或指定文件夹下的文件和文件夹
{ "path": "optional/folder/path" }patchNote - 将内容插入到相对于标题、块引用或前置字段的现有注释中
{ "path": "path/to/note.md", "operation": "append|prepend|replace", "targetType": "heading|block|frontmatter", "target": "target_identifier", "content": "content to insert" }searchWithJsonLogic - 使用 JsonLogic 格式查询搜索 Obsidian 笔记
{ "query": { // JsonLogic query object } }
local-only server
The server can only run on the client's local machine because it depends on local resources.
模型上下文协议服务器使 AI 助手能够通过标准化界面读取、写入和操作 Obsidian 保险库中的笔记。
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityThis project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.Last updated -1177209MIT License
- -securityAlicense-qualityA server implementation that allows AI assistants to read, create, and manipulate notes in Obsidian vaults through the Model Context Protocol.Last updated -6815MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to interact with your Obsidian vault through the Local REST API plugin, allowing reading, creating, searching, and managing notes.
- AsecurityAlicenseAqualityA Model Context Protocol server that connects AI assistants to GitHub repositories containing Obsidian vaults, enabling them to read, search, and analyze notes and documentation stored on GitHub.Last updated -435MIT License