快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

黑曜石HTTP MCP

最后使用Claude Code来管理你的黑曜石笔记——不再有崩溃或管道破裂

也兼容：Claude Desktop、Codex、Gemini和其他MCP客户

](https://www.npmjs.com/package/obsidian-http-mcp) ](https://www.npmjs.com/package/obsidian-http-mcp) ![License: MIT](./LICENSE) ![Sponsor](https://github.com/sponsors/NasAndNora)

______________________________________________________________________

为什么存在

Obsidian的第一个HTTP原生MCP服务器。解决影响Claude Code CLI的stdio传输故障（BrokenPipeError）。HTTP完全绕过了这些问题。

快速高效：响应时间＜200ms，API调用次数减少70%，MCP针对最低令牌使用量进行了优化

______________________________________________________________________

🎬 在行动中看到它

Obsidian HTTP MCP Demo

Claude Code通过HTTP原生MCP控制黑曜石金库-没有stdio错误，只有无缝的AI笔记管理

______________________________________________________________________

🎯 是什么让这与众不同？

✅ 工作的HTTP -没有stdio崩溃，没有BrokenPipeError，没有挫折感

⏱️ 闪电般快速 -即时创建、查找、编辑和移动笔记，即使有拼写错误

🛡️ 永不丢失数据 -内置保护，防止意外删除

⚙️ 1分钟内完成设置 -无需复杂的配置，开箱即用

💪 专为实际使用而打造 -处理数千张钞票而不会减速

💸 代币意识 -智能设计最大限度地降低了人工智能的使用成本

______________________________________________________________________

⚡ 快速入门（1分钟）

💡 代码库新手？ 请人工智能助手指导您： *“根据README.md和TECHNICAL.md，向我介绍HTTP原生MCP服务器的工作原理”*

先决条件

Node.js 18+ - 点击此处下载
MCP兼容AI （例如。，克劳德代码CLI克劳德桌面、Codex等）

步骤1：配置黑曜石插件

设置→ 社区插件→ 搜索“本地REST API”→ 启用
启用“非加密（HTTP）API”
复制API密钥 （接下来你需要它）

______________________________________________________________________

步骤2：安装和设置

在安装黑曜石的地方安装：

npm install -g obsidian-http-mcp
obsidian-http-mcp --setup
# Enter your Obsidian API key when prompted
# Press Enter to accept defaults for URL and port

配置已保存到 ~/.obsidian-mcp/config.json -你无需再次输入此内容。

跨平台用户： 如果您的AI在WSL2上运行，但在Windows上运行Obsidian，请在Windows上安装服务器。

______________________________________________________________________

步骤3：启动服务器

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

obsidian-http-mcp

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

______________________________________________________________________

第四步：连接你的人工智能

如果你的AI在服务器安装的地方运行：

claude mcp add -s user --transport http obsidian-http http://localhost:3000/mcp  # Adapt command to your AI

如果你的AI在别处运行 （例如，WSL2上的Claude，Windows上的服务器）：

在上查找服务器的IP地址 服务器运行的系统:

# Windows PowerShell
ipconfig | findstr "vEthernet"

# Linux
ip addr show | grep inet

连接来源 你的AI在哪里运行:

claude mcp add -s user --transport http obsidian-http http://SERVER_IP:3000/mcp  # Adapt command to your AI

______________________________________________________________________

第五步：与你的人工智能一起使用

在安装AI的地方运行（Windows、Linux或WSL2）：

claude  # Or your AI CLI command
# Try: "List all folders in my Obsidian vault"

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

______________________________________________________________________

🔄 更新中

要更新到最新版本：

npm install -g obsidian-http-mcp@latest

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

obsidian-http-mcp

______________________________________________________________________

✨ 你的黑曜石，由人工智能驱动

不再在AI和Obsidian之间切换 -直接从AI助手控制您的保险库

永不丢失数据 -软删除可防止意外的AI操作（文件移动到 .trash-http-mcp/ 默认情况下）

以AI速度工作 -模糊搜索即使有打字错误也能找到文件，智能缓存将API调用减少70%

自信地扩展 -处理1000+张钞票而不流汗（响应时间\ Obsidian REST API key (overrides config) --base-url Obsidian REST API URL (default: http://127.0.0.1:27123) --port Server port (default: 3000) --help, -h Show help --version, -v Show version

Config Priority: 1. CLI arguments (--api-key, --base-url, --port) 2. Environment variables (OBSIDIAN_API_KEY, OBSIDIAN_BASE_URL, PORT) 3. Config file (~/.obsidian-mcp/config.json) 4. .env file


**替代方法：使用.env文件** （与黑曜石系统相同）：

1. 创建 `.env` 随着 `OBSIDIAN_API_KEY=your_key`
1. 运行： `obsidian-http-mcp` （Windows PowerShell或Linux终端）

______________________________________________________________________

## 🔧 故障排除

### WSL2:连接被拒绝

**查找您的Windows网桥IP：**

开 **Windows PowerShell** （非WSL2）：

ipconfig | findstr "IPv4"

Look for "vEthernet (WSL)" interface

Example output: IPv4 Address. . . . . . . . . . . : 172.19.32.1


然后从重新连接 **WSL2终端**:

claude mcp add -s user --transport http obsidian-http http://YOUR_IP:3000/mcp

Replace YOUR_IP with the IP from above


> **为什么不 `127.0.0.1:27123` 直接？** 端口27123是Obsidian的REST API（自定义HTTP协议）。端口3000是MCP服务器，用于在MCP协议（由您的AI使用）和Obsidian的REST API之间进行转换。它们是不同的协议——MCP服务器充当翻译器/代理。

### Windows防火墙阻止WSL2

运行在 **以管理员身份使用Windows PowerShell**:

New-NetFirewallRule -DisplayName "MCP Server" -Direction Inbound -LocalPort 3000 -Protocol TCP -Action Allow


### 端口已在使用中

在与Obsidian相同的系统上运行（Windows PowerShell或Linux终端）：

obsidian-http-mcp --api-key YOUR_KEY --port 3001


**需要更多帮助？** 看 [故障排除.md](./TROUBLESHOOTING.md) 详细的故障排除和 [技术.md](./TECHNICAL.md) 对于网络架构。

______________________________________________________________________

## ⚠️ 安全通知

**专为可信网络而设计** （本地主机、局域网、VPN）。对于生产部署：

- 使用带有身份验证的反向代理（nginx/caddy）
- 启用HTTPS/TLS
- 配置速率限制
- 看 [安全.md](./SECURITY.md) 查看完整清单

**当前状态**：绑定到 `0.0.0.0` 跨平台兼容性（WSL2↔ Windows）。不要直接接触互联网。

______________________________________________________________________

## 🤝 贡献

看 [贡献.md](./CONTRIBUTING.md) 用于开发设置和指南。

______________________________________________________________________

## 📝 许可证

麻省理工学院-参见 [许可证](./LICENSE)

______________________________________________________________________

## 🌟 支持

如果这个项目对你有帮助，请在GitHub上加星！

______________________________________________________________________

## 🔗 相关

- [黑名单本地REST API](https://github.com/coddingtonbear/obsidian-local-rest-api)
- [模型上下文协议](https://modelcontextprotocol.io/)
- [克劳德代码CLI](https://claude.ai/code)

______________________________________________________________________

内置于❤️ 黑曜石+人工智能社区

目录标签

知识管理HTTP服务器TypeScriptClaudeObsidian插件笔记管理本地部署AI集成MCP协议

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

未说明

鉴权方式（authType，认证方式）

api-key

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

未说明api-key部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

仍需确认：installCommand

来源信息

MCP World

mcpworld.com

/detail/0d34c483af1693a35ccee38eb0aef53e

首个为Obsidian设计的HTTP原生MCP服务器，解决Claude Code CLI中的stdio传输错误，实现AI驱动的无缝笔记管理。

继续浏览同类 MCP

更多文档知识 MCP（3,282）返回 MCP 目录

上一个 MCP

Obsidian Git MCP

一个为Claude和其他AI工具提供Obsidian知识库读写访问的MCP服务器，支持远程笔记管理。

下一个 MCP

Obsidian iCloud MCP

通过模型上下文协议（MCP）将存储在iCloud Drive中的Obsidian Vault连接到AI的工具，主要用于开发调试和生产环境中的Obsidian与AI集成。