MCP Servers

MCP サーバー

このリポジトリには、Cursor の機能を強化するためのさまざまな Model Context Protocol（MCP）サーバーが含まれています。

前提条件

インストールする前に、以下を確認してください。

1. オペレーティングシステム

   • macOS（Homebrew を使用）または
   • Linux（apt-get を使用）

2. システム要件

   • Python 3.10 以降
   • Node.js 18 以降（デフォルトのインストール：Node.js 22.13.1）
   • インストールディレクトリへの書き込み権限

インストール

このリポジトリには、自動インストール用の包括的な Makefile が含まれています。

1. 第 1 フェーズ（システムのセットアップ）：

make phase1

2. ターミナルを再起動します

3. 第 2 フェーズ（MCP のインストール）：

make phase2

その他の Make コマンド

• make update-all：すべての MCP サーバーを更新します
• make clean：インストール済みの依存関係を削除します
• make clean-deep：システムを完全にクリーンアップします

利用可能な MCP サーバー

1. Git MCP

ローカルの Git リポジトリとのやり取りと自動化：

• リポジトリの状態確認とファイル操作
• ブランチとコミットの管理
• 差分操作（ステージ済み、未ステージ、ブランチ間）

2. Brave Search MCP

ウェブ検索とローカル検索の機能：

• フィルタリング付きウェブ検索
• ローカルビジネスの検索
• ニュースと記事の検索

3. GitHub MCP

GitHub との統合と自動化：

• リポジトリの管理
• Issue と PR の処理
• ブランチ操作

4. Memory MCP

永続的な保存と取得：

• ナレッジグラフの管理
• エンティティと関係の追跡
• 検索機能

5. Sequential Thinking MCP

構造化された問題解決：

• 段階的な分析
• 動的な思考の修正
• コンテキストの維持

設定

必須の API キー

1. Brave Search API キー

   export BRAVE_API_KEY=your_key_here
   

   キーは https://brave.com/search/api/ で取得できます。

2. GitHub Personal Access Token

   export GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here
   

   https://github.com/settings/tokens で生成してください。 必要なスコープ：repo、workflow（任意）

Cursor のセットアップ

Cursor で各 MCP を設定します（Settings > Features > MCP）。

1. Git MCP

   {
     "name": "Git",
     "type": "stdio",
     "command": "uvx mcp-server-git --repository /path/to/your/repo"
   }
   

2. Brave Search MCP

   {
     "name": "Brave Search",
     "type": "stdio",
     "command": "npx -y @modelcontextprotocol/server-brave-search"
   }
   

3. GitHub MCP

   {
     "name": "GitHub",
     "type": "stdio",
     "command": "npx -y @modelcontextprotocol/server-github"
   }
   

4. Memory MCP

   {
     "name": "Memory",
     "type": "stdio",
     "command": "npx -y @modelcontextprotocol/server-memory"
   }
   

5. Sequential Thinking MCP

   {
     "name": "Sequential Thinking",
     "type": "stdio",
     "command": "npx -y @modelcontextprotocol/server-sequential-thinking"
   }
   

トラブルシューティング

1. インストールの問題

   • make verify-installation を実行して、すべてのコンポーネントを確認します
   • システムログでエラーメッセージを確認します
   • すべての前提条件を満たしていることを確認します

2. API キーの問題

   • 環境変数が正しく設定されていることを確認します
   • API キーの権限とスコープを確認します
   • キーの有効期限が切れていないことを確認します

3. Cursor の設定

   • Cursor の MCP 設定を確認します
   • コマンドのパスとパラメーターを確認します
   • 設定を変更した後、Cursor を再起動します