Manage and configure Model Context Protocol (MCP) extensions for desktop and IDE applications, enabling advanced features like web search, local file and Git operations, shell commands, web scraping, HTTP requests, cloud documentation access, database integration, and note management.
Unlock the full potential of Claude MCP Servers through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.
Free tier available • No credit card required
このリポジトリは、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で利用できるようにします:
make
がインストールされていることリポジトリをクローンします:
git clone git@github.com:drapon/claude-mcp-servers.git cd claude-ts-mcps
.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を無視するかどうか
依存関係をインストールして設定します:
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
を使用した場合:
claude_desktop_config.template.json
またはcursor_config.template.json
)と .env
ファイルから設定ファイルが生成されますアプリケーションを再起動します:
変更を反映させるために、Claude デスクトップアプリやCursor IDEを再起動してください。
make all
または make
: デフォルトターゲット。setup
ターゲットを実行しますmake setup
: 依存関係をインストールし、設定ファイルを生成して Claude デスクトップアプリの設定ディレクトリにコピーしますmake select-mcps
: インタラクティブにMCPサーバーを選択して設定します。必要な環境変数の設定も行えますmake cursor-setup
: Cursor IDE用の設定ファイルをインストールしますmake cursor-interactive
: Cursor IDE用のインタラクティブセットアップを実行します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
ファイルとテンプレートファイルを変更することで、設定をカスタマイズできます:
make select-mcps
を使用して、使用したいMCPサーバーのみを有効にできますObsidian 機能を使用するには、.env
ファイルにOBSIDIAN_VAULT_DIR
を設定する必要があります。この機能は以下のツールを提供します:
write_note: Obsidian ノートを作成または更新します
path
: ノートのパス(.md 拡張子はオプション)content
: ノートの内容append
: true の場合、既存のノートに追記します(オプション)delete_note: Obsidian ノートを削除します
path
: 削除するノートのパスread_notes: 複数のノートを一度に読み取ります
paths
: 読み取るノートのパスの配列search_notes: ノート名で検索します
query
: 検索クエリ(大文字小文字を区別しない)例:
// ノートを作成する
write_note({"path": "Projects/新しいプロジェクト", "content": "# 新しいプロジェクト
ここにプロジェクトの詳細を記述します。"})
// ノートに追記する
write_note({"path": "Projects/新しいプロジェクト", "content": "## 追加情報
ここに追加情報を記述します。", "append": true})
// ノートを検索する
search_notes({"query": "プロジェクト"})
// ノートを読み取る
read_notes({"paths": ["Projects/新しいプロジェクト", "Daily/2025-04-12"]})
// ノートを削除する
delete_note({"path": "Projects/古いプロジェクト"})
Claude Code は個別MCP管理を採用しており、プロジェクトごとに必要なMCPサーバーのみを選択して使用できます。
Claude Code では3つのスコープがあります:
.mcp.json
ファイルでチーム共有可能# 1. 個別MCPサーバーをビルド make build-individual-mcps # 2. 既存設定をリセットして新規設定(推奨) make reset-and-setup-claude-code # 3. Claude Code内で動作確認 claude code # Claude Code内で: /mcp
Claude Code内で以下のコマンドを使用してMCPサーバーの状態を確認できます:
/mcp
これにより、接続されているMCPサーバーの一覧と状態が表示されます。
チームで共有したい場合は、project
スコープを使用します:
.mcp.json
ファイルをGitにコミットmake list-claude-code-mcps
で設定を確認make reset-claude-code
で全設定をクリア
## MCP の開発と拡張
このリポジトリに新しい MCP を追加する方法:
1. **新しいサーバーファイルの作成**:
`/ts/src/` ディレクトリに新しい `.ts` ファイルを作成します。既存のファイル(例:`obsidian.ts`)を参考にできます。
2. **必要なスキーマの定義**:
Zod を使用して入力パラメータのスキーマを定義します。
```typescript
const MyToolArgsSchema = z.object({
param1: z.string().describe("パラメータ1の説明"),
param2: z.number().optional().describe("オプションのパラメータ2"),
});
ツール実装の追加:
server.setRequestHandler()
内でツールの動作を実装します。
設定ファイルへの追加:
テンプレートファイル(claude_desktop_config.template.json
とcursor_config.template.json
)に新しい MCP の設定を追加します。
"my-new-tool": { "command": "{{BUN_PATH}}", "args": ["run", "{{PROJECT_ROOT}}/ts/src/my-new-tool.ts", "{{SOME_PARAMETER}}"] }
環境変数の追加:
必要に応じて .env
ファイルに新しい環境変数を追加し、README を更新します。
.env
ファイルのパスが正しいことを確認してくださいbun
コマンドが機能していることを確認してくださいOBSIDIAN_VAULT_DIR
が正しく設定されていることを確認してくださいmake setup
を使用して従来の方法でセットアップしてみてくださいこのプロジェクトはパッケージマネージャーとしてBunのみを使用しています。npm や yarn などの他のパッケージマネージャーはサポートされていないため、すべてのインストールと実行にはbun
コマンドを使用してください。
Discover shared experiences
Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!