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"
      }
    }
  }
}