Smart Connections MCP Server
A security-first MCP server for Smart Connections. Read-only. Path-validated. Auditable.
Exposes Smart Connections embeddings to Claude Code and other clients for semantic search of your Obsidian vault.
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y @gogogadgetbytes/[email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
VAULT_PATH=<value> claude mcp add io.github.gogogadgetbytes-smart-connections -- npx -y @gogogadgetbytes/smart-connections-mcp@0.2.0在終端機中執行。
{ "mcpServers": { "io.github.gogogadgetbytes-smart-connections": { "command": "npx", "args": [ "-y", "@gogogadgetbytes/[email protected]" ], "env": { "VAULT_PATH": "<value>" } } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
A security-first MCP server for Smart Connections. Read-only. Path-validated. Auditable.
Exposes Smart Connections embeddings to Claude Code and other clients for semantic search of your Obsidian vault.
MCP server for Obsidian Smart Connections. Semantic search using your vault's embeddings.
We needed semantic search of our Obsidian vault from Claude Code. Existing options have problems:
This implementation:
git clone https://github.com/gogogadgetbytes/smart-connections-mcp
cd smart-connections-mcp
npm install
npm run build
Add to your Claude Code config:
claude mcp add smart-connections \
-e VAULT_PATH="/path/to/your/obsidian/vault" \
-- node /path/to/smart-connections-mcp/dist/index.js
Or manually add to ~/.claude.json:
{
"mcpServers": {
"smart-connections": {
"command": "node",
"args": ["/path/to/smart-connections-mcp/dist/index.js"],
"env": {
"VAULT_PATH": "/path/to/your/obsidian/vault"
}
}
}
}
Restart Claude Code to load the server.
Once configured, Claude Code can use these tools:
"Search my vault for notes about backup strategies"
→ Uses search_by_text tool
"Find notes similar to Topics/Claude_Code.md"
→ Uses search_similar tool
"Show me the content of Topics/Obsidian.md"
→ Uses get_note tool
"What notes are indexed in my vault?"
→ Uses list_indexed tool
~/.cache/huggingface/# Build
npm run build
# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js
See CONTRIBUTING.md. Security-focused PRs welcome.
To report security vulnerabilities, please email [email protected]. Do not open public issues for security concerns.
MIT - see LICENSE
MCP server for Obsidian Smart Connections. Semantic search using your vault's embeddings.
{ "mcpServers": { "io.github.gogogadgetbytes-smart-connections": { "command": "npx", "args": [ "-y", "@gogogadgetbytes/[email protected]" ], "env": { "VAULT_PATH": "<value>" } } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:VAULT_PATH。
Smart Connections 透過 stdio 在本機執行。
上次檢查時間:2026-11-09。 MCP server for Obsidian Smart Connections. Semantic search using your vault's embeddings.