MCP 服务器

Obsidian MCP

这个项目实现了一个模型上下文协议（MCP）服务器，用于连接人工智能模型和 Obsidian 知识库。通过这个服务器，人工智能模型可以直接访问和操作 Obsidian 笔记，包括读取、创建、更新和删除笔记，以及管理文件夹结构。

README

Obsidian MCP (模型上下文协议) 服务器

这个项目实现了一个 Model Context Protocol (MCP) 服务器，用于连接 AI 模型与 Obsidian 知识库。通过这个服务器，AI 模型可以直接访问和操作 Obsidian 笔记，包括读取、创建、更新和删除笔记，以及管理文件夹结构。

功能特点

与 Obsidian 知识库的无缝集成
支持笔记的读取、创建、更新和删除
支持文件夹的创建、重命名、移动和删除
支持全文搜索功能
符合 Model Context Protocol 规范

前提条件

Node.js (v16 或更高版本)
Obsidian 桌面应用
Obsidian Local REST API 插件 (需要在 Obsidian 中安装)

安装

克隆此仓库：

git clone https://github.com/newtype-01/obsidian-mcp.git
cd obsidian-mcp

安装依赖：

npm install

构建项目：

npm run build

配置

服务器通过环境变量进行配置：

OBSIDIAN_VAULT_PATH: Obsidian 知识库的路径
OBSIDIAN_API_TOKEN: Obsidian Local REST API 插件的 API 令牌
OBSIDIAN_API_PORT: Obsidian Local REST API 插件的端口号 (默认为 27123)

您可以通过以下方式设置环境变量：

复制 .env.example 文件为 .env 并编辑其中的值：

cp .env.example .env

编辑 .env 文件，填入您的实际配置：

OBSIDIAN_VAULT_PATH=/path/to/your/vault
OBSIDIAN_API_TOKEN=your_api_token_here
OBSIDIAN_API_PORT=27123

注意： .env 文件包含敏感信息，已被添加到 .gitignore 中，不会被提交到版本控制系统。

使用方法

直接使用

确保 Obsidian 正在运行，并且已安装和配置了 Local REST API 插件
启动 MCP 服务器：

npm start

服务器将通过标准输入/输出与 AI 模型通信

使用 Docker 部署

使用 Docker Compose (推荐)

确保已安装 Docker 和 Docker Compose
复制并配置环境文件：

cp .env.example .env

编辑 .env 文件，填入您的实际配置：

OBSIDIAN_VAULT_PATH=/path/to/your/vault
OBSIDIAN_API_TOKEN=your_api_token_here
OBSIDIAN_API_PORT=27123

构建并启动容器：

docker-compose up -d

使用 Docker 命令

构建 Docker 镜像：

docker build -t obsidian-mcp .

运行容器：

docker run -d \
  --name obsidian-mcp \
  --env-file .env \
  --network host \
  -v $(OBSIDIAN_VAULT_PATH):$(OBSIDIAN_VAULT_PATH) \
  obsidian-mcp

注意： 使用 Docker 部署时，Docker 容器需要访问主机上的 Obsidian 实例和知识库。确保在 .env 文件中设置了正确的路径和端口，并且使用 network_mode: "host" 或适当的端口映射。

在 MCP 客户端中配置

主流 MCP 客户端通常需要编辑配置文件来设置 MCP 服务器。以下是几种常见的配置方式：

使用 npx 方式

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": [
        "obsidian-mcp"
      ],
      "env": {
        // 如果您已经在项目目录中设置了 .env 文件，则可以保留为空
        // 或者您可以直接在这里设置环境变量：
        // "OBSIDIAN_VAULT_PATH": "/path/to/your/vault",
        // "OBSIDIAN_API_TOKEN": "your_api_token_here",
        // "OBSIDIAN_API_PORT": "27123"
      }
    }
  }
}

使用本地安装方式

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "node",
      "args": [
        "/path/to/obsidian-mcp/build/index.js"
      ],
      "env": {
        // 如果您已经在项目目录中设置了 .env 文件，则可以保留为空
      }
    }
  }
}

使用 Docker 方式

如果您已经使用 Docker 部署了 MCP 服务器，您可以通过以下方式配置 MCP 客户端：

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "obsidian-mcp",
        "npm",
        "start"
      ],
      "env": {
        // Docker 容器已经通过 .env 文件或环境变量配置，此处可以保留为空
      }
    }
  }
}