AI导哈

Obsidian文件管理服务器

一个通过Local REST API插件与Obsidian知识库交互的模型上下文协议(MCP)服务器，提供文件列表、读写、搜索等操作功能。

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

使用说明

黑曜石MCP服务器

模型上下文协议（MCP）服务器，用于通过本地REST API插件与您的黑社会保险库交互。

工具

  • obsidian_list_vault -列出vault根目录中的所有文件/文件夹
  • obsidian_list_dir -列出特定目录中的文件
  • obsidian_read_file -读取文件内容
  • obsidian_create_file -创建新文件
  • obsidian_update_file -用新内容覆盖文件
  • obsidian_append_file -将内容附加到文件
  • obsidian_delete_file -删除文件
  • obsidian_search -在所有vault文件中搜索
  • obsidian_move_file -将文件移动到新路径
  • obsidian_copy_file -将文件复制到新路径
  • obsidian_patch_file -在标题/块/封面插入内容
  • obsidian_get_status -检查API连接状态

先决条件

  • 安装并启用了本地REST API插件的黑名单
  • 带MCP工具包的Docker桌面
  • 黑曜石绑定到0.0.0.0（不仅仅是本地主机）

设置

1.塑造形象

cd C:\Projects\obsidian-mcp
docker build -t obsidian-mcp-server:latest .

2.设定秘密

docker mcp secret set obsidian-mcp.api_key=YOUR_API_KEY_HERE

3.设置主机配置（在config.yaml中）

obsidian-mcp:
  host: 192.168.1.16
  port: "27124"

4.将目录条目添加到custom.yaml

将catalog-entry.yaml的内容粘贴到 registry: 键入： C:\Users\mmith\.docker\mcp\catalogs\custom.yaml

5.添加到注册表.yaml

  obsidian-mcp:
    ref: ""

6.重新启动克劳德桌面

环境变量

变量 必填 默认 描述
OBSIDIAN_API_KEY 是 - 来自OBSIDIAN本地REST API插件的API密钥
OBSIDIAN_HOST 否 127.0.0.1 运行OBSIDIAN的主机
OBSIDIAN_PORT 编号 27124 用于OBSIDIAN REST API的端口
OBSIDIAN_PROTOCOL 否 https 协议（https或http）

建筑

Claude Desktop → MCP Gateway → obsidian-mcp-server → Obsidian Local REST API
                      ↓
              Docker Desktop Secrets
              (obsidian-mcp.api_key)

相关 MCP