Obsidian MCP

🚀 Obsidian-MCP MCP サーバー

このプロジェクトは、TypeScript をベースにした MCP サーバーで、Obsidian との統合を実現しています。主な MCP の概念を示し、以下の要素を含みます。

• Obsidian ライブラリの内容に基づくリソース表現
• ライブラリデータにアクセスするツール
• Obsidian の API との統合

📊 プロジェクト統計データ

📁 ディレクトリ構造

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 ライブラリの内容を検索
  • パスをオプションのパラメータとして受け取ります（デフォルト：ルートディレクトリ）
  • 構造化された JSON レスポンスを返します

API 統合

• HTTPS を通じた Obsidian API との安全な接続
• エラーハンドリング付きのカスタム axios クライアント
• Windows パスの正規化をサポート

🛠️ 開発

前提条件

• Node.js v18+
• TypeScript 5.3+
• Obsidian API キー（OBSIDIAN_API_KEY 環境変数として設定）

セットアップ

# 依存関係のインストール
npm install

# サーバーのビルド
npm run build

# 自動再構築で開発サーバーを起動
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

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

📚 依存関係

ランタイム

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

開発

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