Claude 拡張機能設定ツール
このリポジトリは、Claude デスクトップアプリおよびCursor IDEの機能拡張設定を管理するためのツールです。
概要
Makefile
を使用して、テンプレート (claude_desktop_config.template.json
またはcursor_config.template.json
) と .env
ファイルから設定ファイル (claude_desktop_config.json
またはconfig.json
) を自動生成し、Claude デスクトップアプリまたはCursor IDEの設定ディレクトリにインストールします。
対応している機能
このリポジトリは以下の機能を Claude デスクトップアプリとCursor IDEで利用できるようにします:
- Brave 検索: Web 検索および地域検索
- ファイルシステム: ローカルファイルの操作
- Git: リポジトリ操作
- GitHub: リポジトリ管理
- シェル: コマンド実行
- Puppeteer: Web スクレイピング
- Fetch: HTTP リクエスト
- Claude CLI: コマンドライン連携
- AWS Documentation: AWS 関連情報の検索
- Supabase: データベース連携
- Obsidian: Obsidian ノートの操作
前提条件
- Bunがインストールされていること
- システムに
make
がインストールされていること - Claude デスクトップアプリまたはCursor IDEがインストールされていること
- uvxがインストールされていること(AWS Documentation 機能を使用する場合)
セットアップ
- リポジトリをクローンします:Copy
- .env ファイルを作成します:以下のような内容の
.env
ファイルを作成し、必要な値を設定します。Copy - 依存関係をインストールして設定します:Claude Desktop用の場合:Cursor IDE用の場合:Copyこれにより、以下の処理が行われます:Copy
- ルートディレクトリと
ts
ディレクトリの依存関係がインストールされます select-mcps
を使用した場合:- 有効にするMCPサーバーを選択できます
- 必要な環境変数を対話的に入力できます
- テンプレートファイル(
claude_desktop_config.template.json
またはcursor_config.template.json
)と.env
ファイルから設定ファイルが生成されます - 生成された設定ファイルが適切な設定ディレクトリにコピーされます
- ルートディレクトリと
- アプリケーションを再起動します:変更を反映させるために、Claude デスクトップアプリやCursor IDEを再起動してください。
Makefile コマンド
make all
またはmake
: デフォルトターゲット。setup
ターゲットを実行しますmake setup
: 依存関係をインストールし、設定ファイルを生成して Claude デスクトップアプリの設定ディレクトリにコピーしますmake select-mcps
: インタラクティブにMCPサーバーを選択して設定します。必要な環境変数の設定も行えますmake install
: 依存関係のみをインストールしますmake clean
: 生成されたclaude_desktop_config.json
ファイルを削除します
設定ファイル
claude_desktop_config.template.json
: Claude Desktop用の機能設定のテンプレートファイルcursor_config.template.json
: Cursor IDE用の機能設定のテンプレートファイル.env
: 環境変数を定義するファイル(リポジトリには含まれません)claude_desktop_config.json
: Claude Desktop用の生成された設定ファイル(リポジトリには含まれません)config.json
: Cursor IDE用の生成された設定ファイル(リポジトリには含まれません)
カスタマイズ
.env
ファイルとテンプレートファイルを変更することで、設定をカスタマイズできます:
- .env: 環境固有の値とシークレットをここで定義します
- テンプレートファイル: 機能設定のテンプレートを必要に応じて変更します
- インタラクティブ選択:
make select-mcps
を使用して、使用したいMCPサーバーのみを有効にできます
Obsidian 機能の使用方法
Obsidian 機能を使用するには、.env
ファイルにOBSIDIAN_VAULT_DIR
を設定する必要があります。この機能は以下のツールを提供します:
- write_note: Obsidian ノートを作成または更新します
path
: ノートのパス(.md 拡張子はオプション)content
: ノートの内容append
: true の場合、既存のノートに追記します(オプション)
- delete_note: Obsidian ノートを削除します
path
: 削除するノートのパス
- read_notes: 複数のノートを一度に読み取ります
paths
: 読み取るノートのパスの配列
- search_notes: ノート名で検索します
query
: 検索クエリ(大文字小文字を区別しない)
例:
MCP の開発と拡張
このリポジトリに新しい MCP を追加する方法:
- 新しいサーバーファイルの作成:
/ts/src/
ディレクトリに新しい.ts
ファイルを作成します。既存のファイル(例:obsidian.ts
)を参考にできます。 - 必要なスキーマの定義:
Zod を使用して入力パラメータのスキーマを定義します。Copy
- ツール実装の追加:
server.setRequestHandler()
内でツールの動作を実装します。 - 設定ファイルへの追加:
テンプレートファイル(
claude_desktop_config.template.json
とcursor_config.template.json
)に新しい MCP の設定を追加します。Copy - 環境変数の追加:
必要に応じて
.env
ファイルに新しい環境変数を追加し、README を更新します。
トラブルシューティング
- 問題が発生した場合は、コンソール出力を確認してエラーメッセージがないか確認してください
.env
ファイルのパスが正しいことを確認してくださいbun
コマンドが機能していることを確認してください- Obsidian 機能の場合、
OBSIDIAN_VAULT_DIR
が正しく設定されていることを確認してください - インタラクティブセットアップ中に問題が発生した場合は、
make setup
を使用して従来の方法でセットアップしてみてください - Cursor IDEの設定に問題がある場合は、Cursorの設定画面でMCPの設定パスが正しく指定されているか確認してください
開発方針
このプロジェクトはパッケージマネージャーとしてBunのみを使用しています。npm や yarn などの他のパッケージマネージャーはサポートされていないため、すべてのインストールと実行にはbun
コマンドを使用してください。
This server cannot be installed
A toolkit for managing Claude desktop app extension configurations, enabling features like Brave search, file operations, Git/GitHub integration, shell access, web scraping, HTTP requests, AWS documentation search, and Obsidian note management.
Related MCP Servers
- AsecurityAlicenseAqualityConnects Claude Desktop to Redmine for seamless project and issue management, including searching, creating, updating, and tracking tasks using Redmine's API.Last updated -57PythonMozilla Public License 2.0
- -securityFlicense-qualityLets you use Claude Desktop to interact with your task management data in Things app, enabling you to create tasks, analyze projects, manage priorities, and implement productivity workflows through natural language.Last updated -2
- AsecurityAlicenseAqualityA collection of Model Context Protocol servers that enable Claude Desktop to provide development assistance capabilities with filesystem, Git, shell command, and web search functionality without incurring API usage costs.Last updated -214TypeScriptMIT License
- -securityFlicense-qualityA Multi-Claude Program for interacting with GitHub APIs through Claude Desktop, allowing users to search repositories, manage issues, pull requests, repository settings, workflows, and collaborators.Last updated -1Python