星战科技xingzhan.cloud
返回市场
黑曜石-http-mcp

黑曜石-http-mcp

作者：NasAndNora2 星标更新：2025-11-20
安装使用来源：spider==github.com

项目介绍

Obsidian HTTP MCP

终于可以使用 Claude Code 来管理你的 Obsidian 笔记了——不会再有崩溃或管道损坏的问题

首个针对 Obsidian 的原生 HTTP MCP 服务器，解决了影响 Claude Code CLI 的 stdio 传输错误问题（#3071，#9176，[#9662](https://github.com/anthropics/claude-code/issues/9662））

兼容性：Claude Desktop，Codex，Gemini 和其他 MCP 客户端

npm 版本 npm 许可证: MIT 赞助

为什么存在这个项目

首个针对 Obsidian 的原生 HTTP MCP 服务器。解决了影响 Claude Code CLI 的 stdio 传输失败问题（BrokenPipeError）。HTTP 完全绕过了这些问题。

快速且高效：响应时间小于200毫秒，减少70%的 API 调用次数，优化的 MCP 设计以最小化令牌使用

🎬 实际操作演示

Obsidian HTTP MCP 演示

Claude Code 通过原生 HTTP MCP 控制 Obsidian 保险库——没有 stdio 错误，只有无缝的人工智能驱动笔记管理

目录

🎯 什么让它与众不同？

✅ 工作正常的 HTTP —— 没有 stdio 崩溃，没有 BrokenPipeError，没有挫败感

⏱️ 雷霆般的速度 —— 即时创建、查找、编辑和移动笔记——即使有拼写错误

🛡️ 永不丢失数据 —— 内置防止意外删除的保护措施

⚙️ 一分钟设置 —— 不需要复杂的配置，开箱即用

💪 适用于实际使用 —— 处理数千条笔记而不会变慢

💸 关注令牌 —— 智能设计最小化人工智能使用成本

⚡ 快速开始（1分钟）

💡 新手？ 让一个AI助手引导你：“基于 README.md 和 TECHNICAL.md，向我解释如何工作原生 HTTP MCP 服务器”

先决条件

  1. Obsidian 和 Local REST API 插件
  2. Node.js 18+ —— 下载地址
  3. 与 MCP 兼容的人工智能（例如，Claude Code CLI，Claude Desktop，Codex 等）

步骤 1：配置 Obsidian 插件

  • 设置 → 社区插件 → 搜索“Local REST API” → 启用
  • 启用“非加密（HTTP）API”
  • 复制 API 密钥（下一步会用到）

步骤 2：安装和设置

在安装 Obsidian 的位置安装：

npm install -g obsidian-http-mcp
obsidian-http-mcp --setup
# 输入提示时输入你的 Obsidian API 密钥
# 按 Enter 接受默认的 URL 和端口

配置保存到 ~/.obsidian-mcp/config.json —— 你无需再次输入这些信息。

跨平台用户：如果你的人工智能运行在 WSL2 上，但 Obsidian 运行在 Windows 上，请在 Windows 上安装服务器。

步骤 3：启动服务器

在安装的位置（与 Obsidian 同一系统）：

obsidian-http-mcp

⚠️ 保持此终端运行。 重启后，请再次运行 obsidian-http-mcp。

步骤 4：连接你的 AI

如果 AI 运行在服务器安装的位置：

claude mcp add -s user --transport http obsidian-http http://localhost:3000/mcp  # 根据你的 AI 调整命令

如果 AI 运行在其他地方（例如，Claude 在 WSL2 上，服务器在 Windows 上）：

  1. 找到服务器的 IP 地址，在 服务器运行的系统上：
# Windows PowerShell
ipconfig | findstr "vEthernet"

# Linux
ip addr show | grep inet
  1. 从 AI 运行的地方 连接：
claude mcp add -s user --transport http obsidian-http http://SERVER_IP:3000/mcp  # 根据你的 AI 调整命令

步骤 5：与你的 AI 一起使用

在安装 AI 的位置运行（Windows、Linux 或 WSL2）：

claude  # 或你的 AI 命令行命令
# 尝试："列出我的 Obsidian 保险库中的所有文件夹"

就这样！ 每次你开始对话时，你的 AI 会自动连接到服务器（只要服务器正在运行）。

🔄 更新

要更新到最新版本：

npm install -g obsidian-http-mcp@latest

更新后，重新启动服务器：

obsidian-http-mcp

🤝 由人工智能驱动的 Obsidian

不再需要在 AI 和 Obsidian 之间切换 —— 直接从你的 AI 助手中控制你的保险库

永不丢失数据 —— 软删除保护防止意外的人工智能操作（文件默认移动到 .trash-http-mcp/）

以人工智能的速度工作 —— 模糊搜索即使有拼写错误也能找到文件，智能缓存减少了70%的 API 调用

自信地扩展 —— 处理超过1000个笔记而不费吹灰之力（响应时间小于200毫秒）

你可以做什么：

  • 无缝读取、编写和编辑笔记，无需离开你的 AI 对话
  • 使用模糊匹配即时找到任何文件（“会议笔记”找到“Meeting-Notes-2024.md”）
  • 使用完整的正则表达式支持在几秒钟内搜索数千个笔记
  • 使用内置的安全特性移动、重命名或删除文件

参见 TECHNICAL.md 获取完整的工具规格和架构细节。

📖 命令行选项

obsidian-http-mcp --help

选项：
  --setup              交互式设置（保存到 ~/.obsidian-mcp/config.json）
  --api-key <key>      Obsidian REST API 密钥（覆盖配置）
  --base-url <url>     Obsidian REST API URL（默认：http://127.0.0.1:27123）
  --port <port>        服务器端口（默认：3000）
  --help, -h           显示帮助
  --version, -v        显示版本

配置优先级：
  1. 命令行参数（--api-key, --base-url, --port）
  2. 环境变量（OBSIDIAN_API_KEY, OBSIDIAN_BASE_URL, PORT）
  3. 配置文件（~/.obsidian-mcp/config.json）
  4. .env 文件

替代方案：使用 .env 文件（与 Obsidian 同一系统）：

  1. 创建 .env 文件，内容为 OBSIDIAN_API_KEY=your_key
  2. 运行：obsidian-http-mcp（Windows PowerShell 或 Linux 终端）

🔧 故障排除

WSL2：连接被拒绝

找到你的 Windows 桥接 IP：

在 Windows PowerShell（不是 WSL2）中：

ipconfig | findstr "IPv4"
# 查找 "vEthernet (WSL)" 接口
# 示例输出：IPv4 地址. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .