Enables Web search and regional search capabilities using Brave Search API
Integrates with Figma design platform using API key authentication
Provides tools for repository operations, allowing manipulation of local Git repositories
Offers repository management functionality for GitHub, using personal access tokens for authentication
Allows creating, reading, updating, appending to, and deleting notes within an Obsidian vault, plus search functionality
Enables web scraping capabilities to extract information from websites
Provides database integration with Supabase services
Claude 拡張機能設定ツール
このリポジトリは、Claude デスクトップアプリ、Cursor IDE、Claude Codeの機能拡張設定を管理するためのツールです。
概要
Makefile
を使用して、テンプレート (claude_desktop_config.template.json
またはcursor_config.template.json
) と .env
ファイルから設定ファイル (claude_desktop_config.json
またはconfig.json
) を自動生成し、Claude デスクトップアプリまたはCursor IDEの設定ディレクトリにインストールします。
Claude Code向けには、個別MCPサーバーの管理機能も提供します。
対応している機能
このリポジトリは以下の機能を Claude デスクトップアプリとCursor IDEで利用できるようにします:
- Brave 検索: Web 検索および地域検索
- ファイルシステム: ローカルファイルの操作
- Git: リポジトリ操作
- GitHub: リポジトリ管理
- シェル: コマンド実行
- Puppeteer: Web スクレイピング
- Fetch: HTTP リクエスト
- Claude CLI: コマンドライン連携
- AWS Documentation: AWS 関連情報の検索
- Supabase: データベース連携
- Obsidian: Obsidian ノートの操作
前提条件
- Bunがインストールされていること
- システムに
make
がインストールされていること - Claude デスクトップアプリ、Cursor IDE、またはClaude Codeがインストールされていること
- uvxがインストールされていること(AWS Documentation 機能を使用する場合)
- Claude Code用: Claude CLIがインストールされていること
セットアップ
- リポジトリをクローンします:
- .env ファイルを作成します:以下のような内容の
.env
ファイルを作成し、必要な値を設定します。 - 依存関係をインストールして設定します:Claude Desktop用の場合:Cursor IDE用の場合:Claude Code用の場合:これにより、以下の処理が行われます:
- ルートディレクトリと
ts
ディレクトリの依存関係がインストールされます select-mcps
を使用した場合:- 有効にするMCPサーバーを選択できます
- 必要な環境変数を対話的に入力できます
- テンプレートファイル(
claude_desktop_config.template.json
またはcursor_config.template.json
)と.env
ファイルから設定ファイルが生成されます - 生成された設定ファイルが適切な設定ディレクトリにコピーされます
- ルートディレクトリと
- アプリケーションを再起動します:変更を反映させるために、Claude デスクトップアプリやCursor IDEを再起動してください。
Makefile コマンド
Claude Desktop / Cursor IDE 用
make all
またはmake
: デフォルトターゲット。setup
ターゲットを実行しますmake setup
: 依存関係をインストールし、設定ファイルを生成して Claude デスクトップアプリの設定ディレクトリにコピーしますmake select-mcps
: インタラクティブにMCPサーバーを選択して設定します。必要な環境変数の設定も行えますmake cursor-setup
: Cursor IDE用の設定ファイルをインストールしますmake cursor-interactive
: Cursor IDE用のインタラクティブセットアップを実行します
Claude Code 用
make build-individual-mcps
: 個別MCPサーバーをdist/
ディレクトリにビルドしますmake setup-claude-code
: Claude Code用MCPサーバーを対話的に設定しますmake reset-and-setup-claude-code
: 既存の設定をリセットしてから新規設定します(推奨)make reset-claude-code
: 既存のClaude Code MCP設定をリセットしますmake list-claude-code-mcps
: 現在設定されているMCPサーバーを一覧表示します
共通
make install
: 依存関係のみをインストールしますmake clean
: 生成された設定ファイルとビルドファイルを削除します
設定ファイル
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
: 検索クエリ(大文字小文字を区別しない)
例:
Claude Code での使用方法
Claude Code は個別MCP管理を採用しており、プロジェクトごとに必要なMCPサーバーのみを選択して使用できます。
MCP スコープについて
Claude Code では3つのスコープがあります:
- local(デフォルト): 現在のプロジェクトでのみ利用可能
- project:
.mcp.json
ファイルでチーム共有可能 - user: 全プロジェクトで利用可能
基本的な使用フロー
Claude Code内での確認
Claude Code内で以下のコマンドを使用してMCPサーバーの状態を確認できます:
これにより、接続されているMCPサーバーの一覧と状態が表示されます。
プロジェクト共有での使用
チームで共有したい場合は、project
スコープを使用します:
- MCPセットアップ時に「project」スコープを選択
- 生成された
.mcp.json
ファイルをGitにコミット - チームメンバーがプロジェクトをクローン後、Claude Codeが自動的にMCPサーバーを認識
トラブルシューティング(Claude Code)
- Claude CLIが見つからない: Claude CLIが正しくインストールされているか確認
- MCPサーバーが接続されない:
make list-claude-code-mcps
で設定を確認 - 権限エラー: Claude Codeの実行時にプロジェクトスコープのMCPを承認
- 設定のリセット:
make reset-claude-code
で全設定をクリア
- ツール実装の追加:
server.setRequestHandler()
内でツールの動作を実装します。 - 設定ファイルへの追加:
テンプレートファイル(
claude_desktop_config.template.json
とcursor_config.template.json
)に新しい MCP の設定を追加します。 - 環境変数の追加:
必要に応じて
.env
ファイルに新しい環境変数を追加し、README を更新します。
トラブルシューティング
- 問題が発生した場合は、コンソール出力を確認してエラーメッセージがないか確認してください
.env
ファイルのパスが正しいことを確認してくださいbun
コマンドが機能していることを確認してください- Obsidian 機能の場合、
OBSIDIAN_VAULT_DIR
が正しく設定されていることを確認してください - インタラクティブセットアップ中に問題が発生した場合は、
make setup
を使用して従来の方法でセットアップしてみてください - Cursor IDEの設定に問題がある場合は、Cursorの設定画面でMCPの設定パスが正しく指定されているか確認してください
開発方針
このプロジェクトはパッケージマネージャーとしてBunのみを使用しています。npm や yarn などの他のパッケージマネージャーはサポートされていないため、すべてのインストールと実行にはbun
コマンドを使用してください。
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
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 -514PythonMozilla 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