N0

newtype-01/obsidian-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

309 stars 49 forks 品質 66 トレンド 19MIT

newtype-01/obsidian-mcp は、https://github.com/newtype-01/obsidian-mcp. からインポートされたMCPサーバー候補です。

概要

newtype-01/obsidian-mcp は、https://github.com/newtype-01/obsidian-mcp. からインポートされたMCPサーバー候補です。

概要(AI 翻訳)

英語 |中文

このプロジェクトは、AIモデルとObsidianの知識ベースを接続するためのModel Context Protocol(MCP)サーバーを実装しています。このサーバーを通じて、AIモデルはObsidianノートに直接アクセス・操作し、ノートの読み取り、作成、更新、削除、フォルダ構造の管理が可能です。

黄一和によって創設されました

特徴

  • ** 🔗 Omsidianのシームレスな統合**:MCPプロトコルを通じたObsidianナレッジベースへの直接アクセス
  • ** 📝 完全なノート管理**:高度なテキスト置換機能でノートの読み取り、作成、更新、削除
  • ** 📁 フォルダ操作**:階層構造を全面的にサポートしたフォルダの作成、名前変更、移動、削除
  • ** 🔍 インテリジェント検索**:すべてのファイル形式にわたる全文検索をスマートスコアリングで行います
  • ** 🤖 AI駆動分析**:新た TRILEMMA-PRINCIPLESフレームワークを用いた戦略的洞察
  • ** 🔗 自動バックリンク生成**:新たに ノート名のインテリジェント検出とウィキリンクへの変換
  • ** ⚡ 精密編集**:方位とブロックレベルのターゲティングを備えた高度なPATCH操作

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Obsidian MCP (Model Context Protocol) Server

English | 中文

This project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.

Created by huangyihe

Features

  • 🔗 Seamless Obsidian Integration: Direct access to Obsidian knowledge bases through MCP protocol
  • 📝 Complete Note Management: Read, create, update, and delete notes with advanced text replacement
  • 📁 Folder Operations: Create, rename, move, and delete folders with full hierarchy support
  • 🔍 Intelligent Search: Full-text search across all file types with smart scoring
  • 🤖 AI-Powered Analysis: NEW Strategic insights using TRILEMMA-PRINCIPLES framework
  • 🔗 Auto Backlink Generation: NEW Intelligent detection and conversion of note names to wikilinks
  • ⚡ Precision Editing: Advanced PATCH operations with heading and block-level targeting
  • 🚀 Dual API Strategy: Obsidian REST API with filesystem fallback for maximum reliability
  • 🎯 Context Optimization: Smart content summarization for LLM context length management
  • 📊 Batch Processing: Efficient bulk operations with progress tracking

Supported Tools

The MCP server provides the following comprehensive tools:

📋 Core Operations

  • list_notes: List notes in the Obsidian vault with optional folder filtering
    • NEW recursive parameter: Control whether to list files recursively in subdirectories (default: true)
    • Use recursive: false to list only files in the specified folder without subdirectories
  • read_note: Read the content of a specific note in the Obsidian vault
  • read_multiple_notes: Read content from multiple notes simultaneously for batch processing
  • create_note: Create a new note in the Obsidian vault with full content
  • delete_note: Delete a note from the Obsidian vault
  • search_vault: Advanced search across all file types with filename and content matching
  • move_note: Move or rename notes to new locations (supports all file types including PDFs)
  • manage_folder: Complete folder CRUD operations (create/rename/move/delete)

🚀 Advanced Features

  • update_note: Enhanced Update content using text replacements OR precision insertion

    • Traditional text replacement mode
    • NEW Heading-based insertion (before/after/append/prepend)
    • NEW Block ID-based insertion with ^block-id support
    • NEW PATCH API integration with filesystem fallback
  • auto_backlink_vault: 🔗 Auto Backlink Generation

    • Intelligently scan entire vault for note name mentions
GitHub で README 全文を見る

インストール

npx @huangyihe/obsidian-mcp
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "obsidian-mcp": { "command": "npx", "args": [ "@huangyihe/obsidian-mcp" ], "env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/vault", "OBSIDIAN_API_TOKEN": "your_api_token", "OBSIDIAN_API_PORT": "27123" } } } }