AI导哈

Obsidian MCP服务器

一个连接Claude（或任何MCP客户端）到Obsidian vault的MCP服务器，通过Obsidian本地REST API实现文件编辑和笔记撰写功能。

  • by kanishkez
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 kanishkez/obsidian-mcp

使用说明

黑曜石MCP服务器

该项目提供了一个 MCP服务器 通过以下方式将Claude（或任何MCP客户端）连接到您的黑曜石保险库 黑名单本地REST API。它允许您直接使用Obsidian编辑文件，甚至可以在vault中写笔记。

先决条件

  • python 3.9+
  • pip
  • 黑曜石与 REST API插件 启用
  • Claude Desktop（或任何其他MCP客户端）

设置

克隆或复制此项目，并确保存在以下文件：

  • obsidian.py --MCP服务器
  • .env --配置值（未签入git）
  • requirements.txt

需求

创建一个 requirements.txt 文件：

fastmcp
requests
python-dotenv
PyPDF2

安装依赖项：

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

⸻

配置

在项目根目录中创建.env文件：

VAULT_URL=https://127.0.0.1:27124/vault
API_TOKEN=your_api_token_here

更新.gitignore以排除本地机密和环境文件：

.env
.venv/

运行服务器

选项1：手动运行

python -u obsidian.py

选项2：使用内联环境变量运行

VAULT_URL="https://127.0.0.1:27124/vault" \
API_TOKEN="your_api_token_here" \
python obsidian.py

Claude桌面集成

要连接Claude Desktop，请将此服务器添加到MCP配置中。 JSON代码段示例：

{
  "name": "Obsidian MCP Server",
  "command": ["/usr/bin/env", "python3", "-u", "/absolute/path/to/obsidian.py"],
  "cwd": "/absolute/path/to/project",
  "transport": "stdio",
  "env": {
    "VAULT_URL": "https://127.0.0.1:27124/vault",
    "API_TOKEN": "your_api_token_here"
  }
}

相关 MCP