dan6684/smart-connections-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

11 stars 7 forks 품질 52 트렌드 18

Repository Install

MCP server that exposes Obsidian Smart Connections vector database to Claude Code via semantic search

개요

Exposes your Obsidian Smart Connections vector database to Claude Code via Model Context Protocol (MCP). Instead of using text-based Grep, Claude Code can now perform across your vault: - : Find notes by meaning, not keywords - : Get related notes (like Smart Connections sidebar) - : Get best context for RAG queries The script will: - ✅ Install UV package manager (if needed) - ✅ Create virtual environment - ✅ Install all dependencies - ✅ Auto-detect your Obsidian vault - ✅ Configure ~/.mcp.json - ✅ Verify installation Click to expand manual installation steps - mcp>=1.0.0 - Official Model Context Protocol SDK - sentence-transformers>=2.2.0 - For semantic search - numpy =2.0.0 and transformers>=4.30.0 - ML dependencies Use the virtual environment Python, not system Python! Keep this MCP server in a from your Obsidian vault. See DEPLOYMENT.md for rationale and best practices.

README

원문 README의 일부입니다. 원문 보기.

Smart Connections MCP Server

Exposes your Obsidian Smart Connections vector database to Claude Code via Model Context Protocol (MCP).

What This Does

Instead of using text-based Grep, Claude Code can now perform semantic search across your vault:

semantic_search: Find notes by meaning, not keywords
find_related: Get related notes (like Smart Connections sidebar)
get_context_blocks: Get best context for RAG queries

Architecture

Smart Connections Plugin
    ↓ (creates)
.smart-env/multi/*.ajson
    ↓ (reads)
This MCP Server
    ↓ (exposes via)
MCP Protocol
    ↓ (consumed by)
Claude Code

Installation

Quick Install (Recommended)

cd ~/smart-connections-mcp
./install.sh

The script will:

✅ Install UV package manager (if needed)
✅ Create virtual environment
✅ Install all dependencies
✅ Auto-detect your Obsidian vault
✅ Configure ~/.mcp.json
✅ Verify installation

Manual Installation

Migration to New Machine

See DEPLOYMENT.md for detailed migration guide.

Quick migration:

# On new machine
git clone https://github.com/dan6684/smart-connections-mcp.git ~/smart-connections-mcp
cd ~/smart-connections-mcp
./install.sh

Important: Keep this MCP server in a separate repository from your Obsidian vault. See DEPLOYMENT.md for rationale and best practices.

Troubleshooting

If you see timeout issues, see TROUBLESHOOTING.md.

Usage Examples

Semantic Search

Old way (Grep):

Grep pattern: "self-compassion"
→ Only finds notes with exact word "self-compassion"

New way (Semantic Search):

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "smart-connections": {
      "command": "/Users/YOUR_USERNAME/smart-connections-mcp/.venv/bin/python",
      "args": ["/Users/YOUR_USERNAME/smart-connections-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}