MCP Server Collection

🚀 MCP サーバー集合

このプロジェクトは、Claude Desktop、Cursor、GitHub Copilot などの AI アシスタントの機能を強化するために、複数のサービスと API を統合したモデルコンテキストプロトコル (MCP) サーバー集合です。

🚀 クイックスタート

この MCP サーバー集合は、AI アシスタントの機能を強化するために、複数のサービスと API を統合しています。以下の手順でセットアップして利用できます。

✨ 主な機能

このプロジェクトでは、複数の MCP サーバーを実装しており、以下のサービスの統合をサポートしています。

• Brave Search: Brave Search API を使用して、ウェブ検索機能を提供します。
• ファイルシステム: ローカルのファイルとディレクトリ操作を管理します。
• Git: Git バージョン管理操作を実行します。
• GitHub: GitHub リポジトリとのやり取りを行います。
• Shell: ターミナルでコマンドを実行します。
• Figma: Figma のデザインリソースを操作します。
• Slack: Slack との通信を行います。
• Firecrawl: ウェブクローラータスクを実行します。
• Notion: Notion ワークスペース内のデータを操作します。
• Think: 複雑な問題の構造化推論環境を提供します。

📦 インストール

1. このリポジトリをローカルにクローンします。

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

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

   npm install
   

3. MCP サーバーを起動します。
   • 開発環境の場合は、npm run dev を実行します。
   • 本番環境の場合は、PM2 でプロセスを管理します。

📚 ドキュメント

設定について

各 MCP サーバーの設定は、プロジェクトの config ディレクトリにあります。必要に応じて以下の内容を変更してください。

• API キー: secrets.json に必要なすべての API 認証情報を追加します。
• 許可ディレクトリ: filesystem.json でファイルシステム操作の許可パスを指定します。
• コマンドホワイトリスト: shell.json で実行を許可する Shell コマンドを定義します。

使用方法

1. MCP サーバーを AI アシスタントの設定に追加します。

   {
     "servers": [
       { "name": "brave-search", "url": "http://localhost:3000" },
       { "name": "filesystem", "url": "http://localhost:3001" },
       // 他のサーバー設定を追加
     ]
   }
   

2. AI アシスタントのコードで必要なモジュールをインポートします。

   import { FileSystem } from './src/filesystem';
   const fs = new FileSystem();
   

機能詳細

ファイルシステム

• ファイルの読み取り: 指定されたパスのファイル内容を取得します。
• ファイルの書き込み: ファイルを作成または上書きし、新しい内容を書き込みます。
• ディレクトリの一覧表示: 指定されたディレクトリ内のすべてのファイルとサブディレクトリを返します。
• 削除操作: ファイルまたは空のディレクトリを削除します。

Git 操作

• リポジトリのクローン: リモート URL から Git リポジトリをローカルにクローンします。
• 変更のコミット: 変更されたファイルを現在のブランチにコミットします。
• ブランチの切り替え: 異なる Git ブランチ間で切り替えます。
• 更新の取得: リモートリポジトリから最新のコードを取得し、現在のブランチにマージします。

GitHub 統合

• 新しいリポジトリの作成: API を使用して新しい GitHub リポジトリを作成します。
• リポジトリのフォーク: 既存のリポジトリのフォークを作成します。
• 変更のコミット: ローカルの変更を指定されたリモートリポジトリにプッシュします。
• リポジトリ情報の取得: 特定のリポジトリの詳細情報（貢献者やブランチを含む）を取得します。

Shell コマンド

• コマンドの実行: ユーザーが提供したコマンドをターミナルで実行します。
• 出力の取得: コマンドの標準出力、エラー出力、および終了ステータスコードを返します。
• ファイル操作: ファイルやディレクトリの名前変更、削除、および新規作成をサポートします。

Figma デザイン

• ページの作成: Figma プロジェクトに新しいデザインページを追加します。
• コンポーネントの取得: 特定のコンポーネントの詳細情報（属性やバージョン履歴を含む）を取得します。
• レイアウトの更新: ページ内の要素の位置とサイズを変更します。
• リソースのエクスポート: 選択したデザインアセットを複数の形式でエクスポートします。

Slack 通信

• メッセージの送信: 指定されたチャンネルにテキストまたは Markdown 形式のメッセージを送信します。
• チャット履歴の取得: 特定の期間内のチャット履歴を取得します。
• 添付ファイルの追加: ファイルをアップロードし、メッセージに添付して送信します。
• 直接メッセージ: 特定のユーザーにプライベートメッセージを送信します。

ウェブクローラー

• クローラーの起動: 指定された URL でクローラータスクを初期化します。
• 結果の取得: クロールしたデータ（HTML 内容やリンクを含む）を取得します。
• ルールの設定: クローラーの動作（クロール深度や特定の URL の除外など）を定義します。
• タスクの中止: いつでも現在のクローラータスクを停止します。

Notion ワークスペース

• ページの作成: 新しい Notion ページまたはデータベースエントリを追加します。
• 内容の取得: 指定されたページまたはデータベース内のすべてのレコードを取得します。
• 情報の更新: 既存のページまたはデータベースエントリの内容と属性を変更します。
• データの削除: ワークスペースから不要な内容を削除します。

複雑な問題の推論

• クエリの送信: 複雑な問題を複数のサブタスクに分解し、逐一分析して解決します。
• 中間結果の取得: 推論プロセス中の各ステップの出力を取得します。
• 最終回答: 検証済みの最終結論と関連する支持証拠を返します。

セキュリティに関する注意事項

1. 権限管理: API のアクセス権限を厳格に制限し、未承認の操作を防ぎます。
2. 入力フィルタリング: ユーザーが提供した入力を厳密に検証し、消毒処理を行い、注入攻撃を防止します。
3. ログ記録: すべての敏感な操作ログを記録し、監査や問題のトラブルシューティングに役立てます。

よくある質問

1. 大きなファイルのアップロードはどう処理するのですか？
   • チャンクアップロードメカニズムを使用し、適切なタイムアウトポリシーを設定します。
2. Git 操作が失敗した場合はどうすればいいですか？
   • ネットワーク接続とリポジトリの権限を確認し、すべての認証情報が正しく設定されていることを確認します。
3. パフォーマンスを向上させるにはどうすればいいですか？
   • データベースクエリを最適化し、不要なネットワークリクエストを減らします。

コントリビューションガイド

1. コードを提出する前に、ユニットテストを通過していることを確認してください。
2. プロジェクトのコーディング規約に従い、コードスタイルを統一してください。
3. Pull Request を提出する前に、コントリビュータードキュメントを参照して詳細を確認してください。