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

One-click Deploy

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

Obsidian MCP Server