istefox/obsidian-mcp-connector
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
Obsidian 금고가 Claude와 모든 MCP 클라이언트에 노출되어 있습니다. Obsidian 내부에서 실행되고, 기기 내 의미 검색, 클라우드 왕복 없음, 다운로드 바이너리 없이.
개요
Model Context Protocol을 통해 AI 클라이언트에게 노출된 Obsidian 금고. MCP 서버는 루프백 방식으로 실행되며, 다운로드할 바이너리나 클라우드 왕복 경로가 없습니다. Claude Desktop, Claude Code, Cursor, Cline, Continue, Windsurf, VS Code 모두 동일한 엔드포인트에 연결됩니다. - 서버는 루프백에만 바인딩됩니다. 볼트는 Obsidian 자체 app.vault와 app.metadataCache API를 통해 읽기와 쓰기를 하므로 Obsidian의 권한 모델은 여전히 적용됩니다. - 서버는 Obsidian 렌더러에서 실행되는 플러그인 코드로, 미리 구축된 실행 파일을 다운로드하고 실행하는 공급망 표면을 제거합니다. - Transformers.js 임베딩 모델을 로컬에서 실행합니다. API 키나 스마트 연결 요구사항이 없습니다. - 전송은 세션 상태를 유지하지 않으며, 이것이 클라이언트별 도구 표면을 가능하게 합니다. 2.0 버전은 이 커넥터가 다음 MCP 버전을 기다리지 않고 서비스를 제공하기 시작한 버전입니다.
개요(AI 번역)
[! 경고] 알려진 문제: Obsidian 1.14.4에서 이 플러그인이 로드되는 동안 창이 비어 있을 수 있습니다. macOS와 Windows에 영향을 주며, Electron 43 내에서 발생하는 Obsidian 렌더러의 크래시입니다. 이 플러그인 코드에서는 발생하지 않습니다. 제 테스트에서는 대략 10번 중 한 번의 플러그인 로드에서 무작위로 발생합니다. Obsidian을 재부팅하고 플러그인을 다시 활성화하면 보통 잘 작동합니다. Electron 39.8.3(Obsidian 설치 프로그램 1.12.7)에서는 크래시가 없었으니, 원인은 Obsidian 1.14.4가 제공하는 Electron과 V8 빌드에 있다고 생각합니다. 플러그인 쪽에서는 아직 우회 방법이 없습니다. Obsidian 포럼에서 신고했고, 여기 #597과 #609에서 추적 기록이 있습니다.
Model Context Protocol을 통해 AI 클라이언트에 노출된 Obsidian 볼트. MCP 서버는 Obsidian** 내부에서 루프백 방식으로 실행되며, 다운로드할 바이너리나 클라우드 왕복이 없습니다. Claude Desktop, Claude Code, Cursor, Cline, Continue, Windsurf, VS Code 모두 동일한 엔드포인트에 연결됩니다.
3.0.0의 새로운 사항 · 빠른 시작 · 도구 · 렌더링된 검색 결과 · 적응형 도구 로딩 · 클라이언트별 토큰 · 프롬프트 · 프로토콜 · 클라이언트 · 문제 해결 · 보안 · 개발자를 위한
작동 방식
클라이언트 설정은 127.0.0.1:27200의 공유 브로커를 가리킵니다.
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
MCP Connector for Obsidian
[!NOTE] Blank window on Obsidian 1.14 (Electron 43): fixed in 3.1.1. If Obsidian’s window went white while this plugin loaded, update to 3.1.1 or later. Both causes were in the plugin. Read with Electron’s own symbol files, the crash reports hold two signatures. The first is V8 stopping inside a read of Node’s
AsyncLocalStorage: Node 24 (Electron 40 and later) keeps its frames in a V8 slot that Chromium also writes to, and 3.1.0 no longer uses it inside Obsidian. The second is V8 running out of JavaScript heap: every reload of the plugin kept the previous instance in memory, about 40 MB each, through a$arkglobal that the plugin’s schema library registers and never removes, and 3.1.1 removes it at unload. On one Mac, toggling the plugin off and on: 3.0.3 crashed on the first reload and 3.1.0-alpha.2 once in 200 (Obsidian 1.14.5, Electron 43.8.3), 3.1.1 never in 420 (Obsidian 1.15.0, Electron 43.8.3). The reporter of #597 confirmed it on Obsidian 1.14.4 with 3.1.1 and closed the issue. #609 stays open until its reporter confirms. Details in ADR-0032 and on the Obsidian forum.
Your Obsidian vault, exposed to AI clients over the Model Context Protocol. The MCP server runs inside Obsidian, on loopback, with no binary to download and no cloud round-trip. Claude Desktop, Claude Code, Cursor, Cline, Continue, Windsurf and VS Code all connect to the same endpoint.
설치
npx -y mcp-remote http://127.0.0.1:27200/v1/<route-id>/mcp --header Authorization: Bearer YOUR_TOKEN설정
{
"mcpServers": {
"obsidian_my_vault": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://127.0.0.1:27200/v1/<route-id>/mcp",
"--header", "Authorization: Bearer YOUR_TOKEN"]
}
}
}