Obsidian MCP Tools

🚀 MCP 工具插件

MCP 工具插件（Model Context Protocol Tools、略称 MCP Tools）は、Obsidian 用に設計されたプラグインセットです。これは、モデルコンテキストプロトコル（MCP）に準拠した AI サービスとの対話を目的としています。このプラグインは、データの入力、処理、出力などの機能をサポートし、複数の MCP クライアントと互換性があります。

🚀 クイックスタート

MCP 工具插件を使用する前に、以下の手順を実行してください。

1. 必要な前提条件を満たしていることを確認します。
2. プラグインをダウンロードしてインストールします。
3. インストールが完了したら、Obsidian を再起動します。
4. サイドバーから MCP 工具插件のアイコンを選択します。
5. 表示される画面で API キーまたはアクセストークンを設定します。
6. MCP サービスの使用を開始します。

✨ 主な機能

• MCP プロトコルに準拠した AI サービスとの対話
• データの入力、処理、出力機能の提供
• 複数の形式でのデータ交換のサポート

📦 インストール

前提条件

• Obsidian の最新バージョン
• インターネット接続

ダウンロードとインストール

1. MCP Tools リポジトリにアクセスします。
2. Releases ページから、お使いのシステムに適したプラグインパッケージをダウンロードします。
3. ダウンロードした .zip ファイルを解凍し、以下の Plugins フォルダにコピーします。

   Windows: C:\Users\<あなたのユーザー名>\AppData\Roaming\Obsidian\Plugins
   macOS: /Users/<あなたのユーザー名>/Library/Application Support/Obsidian/Plugins
   Linux: ~/.config/obsidian/Plugins
   

💻 使用例

基本的な使用法

1. インストールが完了したら、Obsidian を再起動します。
2. サイドバーから MCP 工具插件のアイコンを選択します。
3. 表示される画面で API キーまたはアクセストークンを設定します。
4. MCP サービスの使用を開始します。

📚 ドキュメント

セキュリティ

バイナリ配布

• すべてのリリースバージョンは GitHub Actions を通じて再現可能にビルドされます。
• バイナリファイルには SLSA 出証が付与され、完全性とソースが保証されます。
• リリースワークフローは完全にオープンソース標準に準拠しています。

ランタイムセキュリティ

• サーバーは最小限の権限で実行されます。
• すべての通信は暗号化されます。
• API キーはプラットフォーム固有の資格情報ストアを使用して保護されます。

開発

プロジェクト構造

MCP 工具插件はモノレポ構造を採用しており、以下のモジュールを含んでいます。

packages/
├── mcp-server/        # サーバー実装
├── obsidian-plugin/   # Obsidian プラグイン
└── shared/           # 共通ツールと型

Cline の使用

一部のコードは AI コーディングエージェント Cline で実装されています。プロジェクトのアーキテクチャについては、cline_docs/ と .clinerules ファイルを参照してください。

ワークスペース

このプロジェクトは Bun ワークスペース構造を使用しています。

依存関係の管理

1. 依存関係をインストールします。

   bun install
   

2. すべてのパッケージをビルドします。

   bun run build
   

3. 開発モードで実行します。

   bun run dev
   

構成要件

• Bun v1.1.42 以上
• TypeScript 5.0 以上

貢献ガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. テストを実行します。

   bun test
   

5. Pull Request を送信します。

詳細なガイドについては、CONTRIBUTING.md を参照してください。

サポート

• 問題や機能要求は Issues で報告してください。
• ヘルプが必要な場合は Discussions で質問してください。

変更履歴

詳細な変更履歴については、CHANGELOG.md を参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細な条項は LICENSE ファイルを参照してください。

脚注

1. MCP プロトコルは AI サービスとクライアント間の対話標準を定義しています。
2. プラグインがサポートする API 形式には、JSON、XML、およびカスタム形式が含まれます。
3. すべてのスクリプトは互換性と安定性を確保するために厳密にテストされています。