MCP Server Collection

MCP サーバーコレクション

AI アシスタントとさまざまなサービスや API を連携するために設計された、Model Context Protocol（MCP）サーバーのコレクションです。 このプロジェクトは、Model Context Protocol を通じて Claude Desktop、Cursor、GitHub Copilot などの AI アシスタントを強化できる、包括的な MCP サーバーのハブを提供します。

概要

このプロジェクトでは、さまざまなサービスとの連携を実現する複数の MCP サーバーを実装しています。

• Brave Search：Brave Search API を使用したウェブ検索およびローカル検索機能
• Filesystem：セキュリティ制限付きのファイルシステム操作
• Git：Git リポジトリ管理機能
• GitHub：リポジトリ、イシュー、プルリクエストなどに対応する GitHub API 連携
• Shell：制御された環境でのシェルコマンド実行
• Figma：デザインファイル向けの Figma API 連携
• Slack：メッセージおよびチャンネル情報に対応する Slack API 連携
• Firecrawl：ウェブスクレイピング機能
• Notion：可読性を高めるための Markdown 変換に対応した Notion API 連携
• Think：複雑な問題解決のための構造化された推論スペース（Claude Desktop のみ）

要件

• Node.js（v18 以上）
• JavaScript／TypeScript ランタイムとしての Bun
• MCP に対応する AI アシスタント（例：Claude Desktop、Cursor、GitHub Copilot）

インストール

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

   git clone https://github.com/shigennn/mcp-server-collection.git
   cd mcp-server-collection
   

2. 依存関係をインストールします：

   bun install
   

設定

これらの MCP サーバーを AI アシスタントで使用するには、使用するアシスタントに応じて設定する必要があります。

• Claude Desktop：

  1. Claude Desktop を開きます
  2. メニューバーをクリックし、「Settings」を選択します
  3. 「MCP」セクションに移動して、サーバーを設定します

• Cursor：

  • MCP サーバーは Cursor の「Settings」メニューから設定できます：
    1. Cursor の「Settings」を開きます
    2. 「Features > MCP」に移動します
    3. サーバー設定を追加します

このリポジトリには、config_templates ディレクトリに設定テンプレートが含まれています。

• claude_desktop_config_template.json：Claude Desktop 用の完全な設定

テンプレートを使用するには：

1. config_templates ディレクトリから適切なテンプレートをコピーします
2. <YOUR_USERNAME> と <path> のプレースホルダーを実際の値に置き換えます
3. 必要に応じて API キーとトークンを追加します
4. 設定を AI アシスタントの設定にインポートするか、貼り付けます

注意：Windows のパスではバックスラッシュ（\\）を使用し、macOS または Linux ではスラッシュを使用します。

Cursor ユーザーへの重要な注意：Think ツールは Claude Desktop でのみ使用できます。Cursor を使用している場合は、エラーを避けるため、mcp.json ファイルから Think の設定を削除してください。

API キーとトークンの設定

各サービスとの連携には、適切な API キーを取得して設定する必要があります。

1. Brave Search API：Brave Search API に登録して、API キーを取得します
2. GitHub：適切な権限を持つ個人用アクセストークンを作成します
3. Figma：Figma アカウントでアクセストークンを生成します
4. Slack：Slack アプリを作成して、ボットトークンを生成します
5. Firecrawl：Firecrawl API キーを取得するために登録します
6. Notion：インテグレーションを作成して、API キーを取得します

設定ファイル内のプレースホルダー値を、実際の API キーとトークンに置き換えてください。

使用方法

1. AI アシスタントを起動します
2. アシスタントの要件に応じて MCP サーバーを設定します
3. これで、会話中にアシスタントから連携済みのすべてのサービスにアクセスできるようになります

機能の詳細

Notion 連携

Notion 連携では、次の機能を利用できます。

• ページ、データベース、ブロックの作成、取得、更新、削除
• 検索機能
• 可読性を高めるための Markdown 変換
• データベースのクエリ機能
• コメント機能

GitHub 統合

GitHub 統合では、以下の操作が可能です。

• リポジトリの作成、検索、管理
• ファイルの取得、更新、コミット
• Issue とプルリクエストの管理
• 複数アカウントのサポート

ファイルシステム

以下の機能を使って、ファイルシステムに安全にアクセスできます。

• ファイルの読み取りと書き込み
• ディレクトリの操作
• ファイルの検索
• ファイルメタデータの取得

その他の統合

• Brave Search：ウェブとローカルの検索機能
• Git：リポジトリの管理、コミット、ブランチ操作
• Shell：制御されたシェルコマンドの実行
• Figma：デザインファイルの取得と操作
• Slack：メッセージの送信とチャンネル情報の取得
• Firecrawl：ウェブスクレイピング
• Notion：Notion API との統合

Think 統合

Think 統合では、以下の機能を利用できます。

• 複雑な問題解決のための構造化された思考スペース
• 問題を扱いやすいステップに分解する機能
• 操作を実行せずに、体系的な思考と分析を行うサポート
• ガイド付きの思考プロセスによる意思決定の改善

注：Think ツールは Claude Desktop 専用で、Cursor やその他の環境では動作しません。Cursor ユーザーは、このツールを設定に含めないでください。

開発

各 MCP サーバーは、src フォルダー内のスタンドアロンな TypeScript ファイルまたはディレクトリとして実装されています。

• src/brave-search.ts：Brave Search API との統合
• src/filesystem.ts：ファイルシステムの操作
• src/git.ts：Git 操作
• src/github.ts と src/github/：GitHub API との統合
• src/shell.ts：シェルコマンドの実行
• src/figma.ts：Figma API との統合
• src/slack.ts：Slack API との統合
• src/firecrawl.ts：ウェブスクレイピング
• src/notion.ts と src/notion/：Notion API との統合
• src/think.ts：複雑な問題解決のための構造化された思考スペース

新しい機能を追加するには：

1. src ディレクトリに新しい TypeScript ファイルを作成します
2. @modelcontextprotocol/sdk を使って MCP サーバーを実装します
3. AI アシスタントの設定に新しいサーバーを追加します

セキュリティに関する考慮事項

• ファイルシステムサーバーとシェルサーバーには、不正アクセスを防止するセキュリティ対策が含まれています
• コマンドを実行する前に、必ずユーザー入力を検証してください
• ファイルシステムへのアクセスを許可するディレクトリを設定するときは注意してください
• 実行可能なコマンドを制限するには、シェルサーバーのコマンド許可リストを使用してください
• API キーとトークンは安全に保管し、最小権限の原則に従ってください

参考資料と謝辞

このプロジェクトは、以下のリポジトリをベースにしています。

• ukkz/claude-ts-mcps - MCP サーバーコレクションのオリジナル実装
• suekou/mcp-notion-server - Notion MCP サーバーの参考実装

その他の参考資料：

• Model Context Protocol
• MCP Server Quickstart

ライセンス

MIT License