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がインストールされていること

セットアップ

1. リポジトリをクローンします:

   git clone [email protected]:drapon/claude-mcp-servers.git
   cd claude-ts-mcps
   

2. .env ファイルを作成します:

以下のような内容の .env ファイルを作成し、必要な値を設定します。

   # API Keys and Tokens
   BRAVE_API_KEY=your_brave_api_key         # Brave検索のAPI Key
   GITHUB_TOKEN=your_github_personal_access_token  # GitHub個人アクセストークン
   SUPABASE_API_KEY=your_supabase_api_key   # SupabaseのAPI Key
   FIGMA_API_KEY=your_figma_api_key         # FigmaのAPI Key
# Executables Paths

   BUN_PATH=/path/to/bun                    # bunコマンドのフルパス（通常は /opt/homebrew/bin/bun）

   UVX_PATH=/path/to/uvx                    # uvxコマンドのフルパス（通常は /usr/local/bin/uvx）

   NPX_PATH=/path/to/npx                    # npxコマンドのフルパス

   CLAUDE_CLI_PATH=/path/to/claude/cli      # Claude CLIのフルパス
# Directories

   HOME_DIR=/your/home/directory            # ホームディレクトリのパス

   OBSIDIAN_VAULT_DIR=/path/to/obsidian/vault  # Obsidianのvaultディレクトリ

   CURSOR_WORKSPACE_PATH=/path/to/workspace    # Cursorのワークスペースパス (Cursor用)
# Fetch Tool Configuration

   CUSTOM_USER_AGENT=Mozilla/5.0 (...)      # カスタムユーザーエージェント設定

   IGNORE_ROBOTS_TXT=false                  # robots.txtを無視するかどうか

   

3. 依存関係をインストールして設定します:

Claude Desktop用の場合:

   # MCPサーバーを選択的に有効化する（推奨）
   make select-mcps
# または、従来の自動セットアップ

   make setup

   

Cursor IDE用の場合:

   # Cursor用のMCPサーバーを設定
   ./scripts/setup_cursor_mcp.sh
   

Claude Code用の場合:

   # 個別MCPサーバーをビルドして対話的に設定（推奨）
   make reset-and-setup-claude-code
# または、リセットせずに追加設定

   make setup-claude-code
# 既存の設定をリセットのみ

   make reset-claude-code
# 設定済みMCPサーバーの確認

   make list-claude-code-mcps

   

これにより、以下の処理が行われます:

- ルートディレクトリとtsディレクトリの依存関係がインストールされます
- select-mcpsを使用した場合:
- 有効にするMCPサーバーを選択できます
- 必要な環境変数を対話的に入力できます
- テンプレートファイル（claude_desktop_config.template.jsonまたはcursor_config.template.json）と .env ファイルから設定ファイルが生成されます
- 生成された設定ファイルが適切な設定ディレクトリにコピーされます

4. アプリケーションを再起動します:

変更を反映させるために、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を設定する必要があります。この機能は以下のツールを提供します：

1. write_note: Obsidian ノートを作成または更新します

- path: ノートのパス（.md 拡張子はオプション）
- content: ノートの内容
- append: true の場合、既存のノートに追記します（オプション）

2. delete_note: Obsidian ノートを削除します

- path: 削除するノートのパス

3. read_notes: 複数のノートを一度に読み取ります

- paths: 読み取るノートのパスの配列

4. search_notes: ノート名で検索します
- query: 検索クエリ（大文字小文字を区別しない）

例：

// ノートを作成する
write_note({"path": "Projects/新しいプロジェクト", "content": "# 新しいプロジェクト\n\nここにプロジェクトの詳細を記述します。"})
// ノートに追記する

write_note({"path": "Projects/新しいプロジェクト", "content": "## 追加情報\n\nここに追加情報を記述します。", "append": true})
// ノートを検索する

search_notes({"query": "プロジェクト"})
// ノートを読み取る

read_notes({"paths": ["Projects/新しいプロジェクト", "Daily/2025-04-12"]})
// ノートを削除する

delete_note({"path": "Projects/古いプロジェクト"})

Claude Code での使用方法

Claude Code は個別MCP管理を採用しており、プロジェクトごとに必要なMCPサーバーのみを選択して使用できます。

MCP スコープについて

Claude Code では3つのスコープがあります：

1. local（デフォルト）: 現在のプロジェクトでのみ利用可能
2. project: .mcp.jsonファイルでチーム共有可能
3. user: 全プロジェクトで利用可能

基本的な使用フロー

```bash