Obsidian Mcp

obsidian-mcp

用 Go 编写的 Obsidian 模型上下文协议（MCP）服务。

功能

• 通过 MCP 协议与 Obsidian 交互
• 支持 Obsidian REST API
• 提供工具和提示词功能
• 支持 stdio 和 SSE 两种服务模式

前置条件

此 MCP 服务需要在 Obsidian 中安装并启用 Obsidian Local REST API 插件。该插件提供安全的 HTTPS 接口，使外部工具能够通过 REST API 与 Obsidian 笔记交互。

安装

使用 go install

go install github.com/orvice/obsidian-mcp/cmd/obsidian-mcp@latest

从源代码构建

git clone https://github.com/orvice/obsidian-mcp.git
cd obsidian-mcp
go build -o obsidian-mcp ./cmd/obsidian-mcp

配置

环境变量

• OBSIDIAN_BASE_URL：Obsidian REST API 的基础 URL
• OBSIDIAN_API_KEY：Obsidian REST API 的 API 密钥
• SSE_SERVER：设为 "true" 以启用 SSE 服务模式（可选）

MCP 配置示例

Claude Desktop 配置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "obsidian-mcp",
      "env": {
        "OBSIDIAN_BASE_URL": "http://localhost:27123",
        "OBSIDIAN_API_KEY": "your-obsidian-api-key"
      }
    }
  }
}

Continue 配置

添加到 ~/.continue/config.json：

{
  "experimental": {
    "modelContextProtocol": true
  },
  "mcpServers": {
    "obsidian-mcp": {
      "command": "obsidian-mcp",
      "args": [],
      "env": {
        "OBSIDIAN_BASE_URL": "http://localhost:27123",
        "OBSIDIAN_API_KEY": "your-obsidian-api-key"
      }
    }
  }
}

用法

1. 确保已安装 Obsidian 并启用 REST API 插件
2. 获取 API 密钥并配置环境变量
3. 启动 MCP 服务
4. 在兼容 MCP 的客户端中使用（例如 Claude Desktop）

开发

# Run the project
go run ./cmd/obsidian-mcp

# Run tests
go test ./...

# Build
make build

许可证

MIT 许可证