Obsidian MCP Server

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行)

Related MCP server: my-server MCP Server

ディレクトリ構造

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コンパイラ