Obsidian Scoped-write MCP

指定されたObsidian VaultにアクセスするMCPサービスです。Vault全体は読み取り可能で、Markdownの作成と更新はChatGPT専用の2つのディレクトリのみ許可されています：

• 00-ChatGPT系统入口

• 01-ChatGPT策略主脑

削除、移動、名前変更、またはMarkdown以外の書き込みツールは提供されません。

ツール

• list_directory: ディレクトリを一覧表示します。

• read_markdown: Markdownを読み取ります。

• search_markdown: Markdownを検索します。

• get_file_info: サイズ、変更時刻、SHA-256、書き込み可能状態を確認します。

• create_directory: 許可されたディレクトリ内に1レベルの通常のサブフォルダを作成します。親ディレクトリが存在している必要があります。

• create_markdown: 許可されたディレクトリに新規ファイルを作成します。上書きは禁止です。

• update_markdown: 期待されるSHA-256を使用して既存ファイルを更新します。更新前にVault外にバックアップします。

Related MCP server: Obsidian MCP Local

ローカル検証

npm ci
npm test

テストではデフォルトで一時Vaultと一時バックアップディレクトリを作成し、個人のObsidianデータには触れません。実際のVaultパスを渡した場合は読み取りテストのみ実行し、書き込みは行いません。

セキュリティ境界

• 書き込みディレクトリはサーバー側の固定ホワイトリストで制御され、ツールのパラメータで範囲を拡大することはできません。

• フォルダ作成は1レベルの操作のみ許可されます。同名、隠しディレクトリ、親ディレクトリの欠如、範囲外、シンボリックリンクのエスケープはすべて拒否されます。

• 作成先が既に存在する場合は拒否されます。

• 更新前に get_file_info を呼び出し、返された sha256 を expected_sha256 として使用します。ファイルが変更されている場合、更新は拒否されます。

• 更新前に現在のWindowsユーザーのローカルアプリケーションデータディレクトリにバックアップします。バックアップはVaultやGitリポジトリには含まれません。

• 絶対パス、範囲外パス、シンボリックリンクのエスケープ、およびMarkdown以外はすべて拒否されます。

開発フロー

• main は常にリリース可能な状態を保ちます。

• すべてのリポジトリ変更は短命なブランチとPull Requestを使用します。

• CIが通った後にのみマージされ、デフォルトでsquash mergeを使用します。

• アーキテクチャ、セキュリティ境界、データ形式、長期的な依存関係、または複数の独立したPRにわたる大きな機能：親Issue、Sub-issues、ADR、PR、CI、およびロールバック記録。

• 小さなパッチ：単一のIssueまたはPR、最小限の変更、最小限のテスト、およびロールバックの説明。

軽量パッチの受け入れ

• 受け入れ：npm test を実行し、Pull RequestのCIチェックが通過した後にマージします。

• ロールバック：GitHub上で対応するsquash commitを元に戻します。