Obsidian MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides access to Obsidian vault contents, allowing retrieval of vault files and metadata through the 'get_vault_contents' tool. Connects to the Obsidian API to retrieve information about the vault structure and file contents.

Obsidian統合のためのモデルコンテキストプロトコルサーバー

これはTypeScriptベースのMCPサーバーで、Obsidianとの統合を実装しています。以下の機能を提供することで、MCPのコアコンセプトを実証しています。

  • Obsidian Vault の内容を表すリソース
  • 金庫データにアクセスするためのツール
  • ObsidianとのAPI統合

プロジェクト統計

  • コードの総行数: 345
  • メインファイル:
    • src/tool-handlers.ts (76行)
    • src/resource-handlers.ts (45行)
    • src/server.ts (32行)
    • src/api-client.ts (25行)

ディレクトリ構造

obsidian-mcp/ ├── .codegpt/ │ └── head ├── src/ │ ├── api-client.ts │ ├── index.ts │ ├── resource-handlers.ts │ ├── server.ts │ └── tool-handlers.ts ├── .SourceSageignore ├── package.json ├── README.md └── tsconfig.json

特徴

リソース

  • obsidian://server-info URI 経由で Obsidian サーバー情報にアクセスします。
  • メタデータを含む保管庫の内容を取得する
  • 簡単に統合できるJSON形式

ツール

  • get_vault_contents - Obsidian vault の内容を取得する
    • オプションパラメータとしてパスを受け取ります(デフォルト: ルートディレクトリ)
    • 構造化されたJSONレスポンスを返す

API統合

  • Obsidian API による安全な HTTPS 接続
  • エラー処理機能を備えたカスタム axios クライアント
  • Windows パス正規化のサポート

発達

前提条件

  • Node.js v18+
  • TypeScript 5.3以上
  • Obsidian API キー (OBSIDIAN_API_KEY 環境変数として設定)

設定

# Install dependencies npm install # Build the server npm run build # Start development server with auto-rebuild npm run watch

インストール

Claude Desktop で使用するには、サーバー設定を追加します。

MacOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "obsidian-mcp": { "command": "/path/to/obsidian-mcp/build/index.js", "env": { "OBSIDIAN_API_KEY": "your-api-key-here" } } } }

デバッグ

MCP Inspector の使用をお勧めします。

npm run inspector

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。

依存関係

ランタイム

  • @modelcontextprotocol/sdk: MCP サーバーの実装
  • axios: API通信用のHTTPクライアント

発達

  • @types/node: Node.js 用の TypeScript 定義
  • typescript: TypeScriptコンパイラ

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

この TypeScript ベースの MCP サーバーを使用すると、ユーザーはテキスト ノートを管理および要約することができ、ノート作成および要約プロンプト用のツールが提供されます。

  1. Directory Structure
    1. Features
      1. Resources
      2. Tools
      3. API Integration
    2. Development
      1. Prerequisites
      2. Setup
    3. Installation
      1. Debugging
        1. Dependencies
          1. Runtime
          2. Development
        ID: 02n7aazeu1