MCP Easy Installer

MCP Easy Installer

MCP Easy Installer は、MCP サーバーを検索、インストール、設定、修復、アンインストールするためのツールを備えた堅牢な MCP サーバーです。

MCP サーバーのインストールと修復ツール

MCP Easy Installer は、MCP サーバー（Model Context Protocol）の検索、インストール、設定、修復、アンインストールを行う堅牢なツールです。このユーティリティは、開発者、開発者以外の方、エンドユーザー向けに設計されており、技術的な専門知識がなくても MCP サーバーを簡単にセットアップして保守できます。開発者やシステムインテグレーターも、ワークフローを効率化し、反復的な作業を自動化するために利用できます。このツールはセットアップを簡素化し、修復を自動化して、MCP 環境を常に正常な状態に保ちます。 このツールは、Claude Desktop、Windsurf、Cursor、Roo Code、Cline、*GitHub Copilot など、幅広いアプリケーションに必要なすべての JSON 設定ファイルを自動でインストールし、更新します。AI ツールや開発者ツールのエコシステム全体で、シームレスな連携と最新の設定を実現します。

---

機能

• 検索と検出： インストール可能な MCP サーバーを検索します。
• 自動インストール： GitHub またはローカルソースから MCP サーバーをすばやくインストールします。
• 修復ユーティリティ： 一般的な MCP サーバーの問題を検出して修正します。
• TypeScript 対応： 信頼性と保守性を高めるため、TypeScript で構築されています。
• 詳細なログ： すべての操作について明確なログを記録します。
• クロスプラットフォーム： Windows、Linux、Mac で動作します。

---

インストールに関する重要な注意

MCP Easy Installer は、Node.js を使用した MCP サーバーのインストールに npx を使用しません。
代わりに、すべての MCP サーバーを次のディレクトリに手動でインストールします。

• Windows：

  C:\Users\USERNAME\Documents\Flowvibe\MCP\
  

• Linux/Mac：

  /home/USERNAME/Documents/Flowvibe/MCP/
  

USERNAME を、お使いのシステムの実際のユーザー名に置き換えてください。

---

VS Code - GitHub Copilot 連携に関する注意

GitHub Copilot for VS Code は、このツールでは直接サポートされていません。

GitHub Copilot は独自の方法で MCP を実装しており、他の実装とは大きな違いがあります。こうした違いがあるため、GitHub Copilot はこのツールのサポート対象アプリケーションに含まれていません。

• 回避策： VS Code の GitHub Copilot の MCP サーバー接続を更新する場合は、Claude Desktop をインストールしてください。GitHub Copilot は Claude Desktop の MCP サーバーに接続します。これにより、MCP を介して GitHub Copilot の機能を強化する間接的な方法が利用できます。

---

Python 連携に関する注意

Python と MCP の連携にはいくつかの制限があります。

このツールは複数のプラットフォームや言語とのシームレスな連携を目指していますが、現在の Python サポートはまだ完全ではなく、状況によっては手動での対応が必要になる場合があります。Python 環境、パッケージマネージャー、プロジェクト構造は多種多様なため、自動インストールや設定がすべてのケースで最適に機能するとは限りません。

コミュニティからの貢献を歓迎します。

• Python 連携で問題が発生した場合は、解決策を issue セクションで共有してください
• Python 環境に特化した改善を実装するため、このリポジトリをフォークすることをご検討ください
• Python サポートの強化を含むプルリクエストを大いに歓迎します

共同開発とユーザーからのフィードバックを通じて、Python 連携を改善することを目指しています。

---

インストール

リポジトリをクローンし、依存関係をインストールします。

方法 1：Git でインストール

# Clone the repository
git clone https://github.com/onigetoc/mcp-easy-installer.git

# Navigate to the directory
cd mcp-easy-installer

# Install dependencies
npm install

# Build the project
npm run build

# Test tools
npm run test-tools

方法 2：ダウンロードしてインストール

1. https://github.com/onigetoc/mcp-easy-installer から最新リリースをダウンロードします
2. ファイルを任意の場所に展開します
3. 展開したディレクトリでターミナルを開きます
4. npm install を実行して依存関係をインストールします
5. npm run build を実行して、MCP クライアントで使用できるようアプリケーションをコンパイルします

---

設定

設定ファイルで MCP サーバーを設定します（MCP サーバーの検索には GitHub トークンは任意です。レート制限を防げます）。

デフォルトでは、このツールは TypeScript（ts）、JavaScript（js）、HTML のリポジトリを検索します。--langcode 引数を使って、検索対象をカスタマイズしたり、Python（py）や Shell（sh）などの言語を追加したりできます。たとえば、Python と Shell のリポジトリも検索するには、以下の args リストに "--langcode=ts,js,html,py,sh" を追加します。最も簡単に設定するには、デフォルトを使うために --langcode 引数を省略することをおすすめします。

{
  "mcpServers": {
    "mcp-easy-installer": {
      "command": "node",
      "args": ["path-to\\mcp-easy-installer\\build\\index.js"],
      "env": {
        "GITHUB_TOKEN": "your_github_token"
      }
    }
  }
}

例：サポートされているすべての言語を使った設定

検索に使う言語をカスタマイズする場合は、サポートされているすべての言語コードを含む args 配列の例を以下に示します。この行がない場合、デフォルトは JavaScript、TypeScript、HTML です。

"args": [
  "path-to\\mcp-easy-installer\\build\\index.js",
  "--langcode=ts,js,html,py,sh"
]

// this will also work
"--langcode=typescript,javascript,HTML,python,shell" // Your can add more according to the Github search filter

個人用のGitHub トークンを取得し、「Generate new token」をクリックします（その前にログインするか、GitHub アカウントを作成する必要がある場合があります）。

---

使用例

コミュニティへの質問：GitHub 検索の統合

GitHub 検索機能をこのツールに直接統合するかどうかを検討しています。統合された場合、GitHub API トークンの提供は任意にできます。トークンがない場合、GitHub 検索機能は動作しない（または制限される）一方で、その他のツールや機能はすべて通常どおり使用できます。

コミュニティからのフィードバックをお待ちしています： GitHub 検索の組み込みを希望しますか？ご意見やユースケースを、このリポジトリの Issues または Discussions セクションで共有してください。

次のような自然言語のコマンドを使用できます。

• Search for the fetch mcp server. (follow up prompt: install the third one) Brave や、GitHub または npmjs のリンクを扱えるほかの検索ツールでも機能する場合があります。
• Search Github mcp server "wikipedia server"
• Install this mcp server: https://www.npmjs.com/package/@modelcontextprotocol/server-brave-search（NPMjs または GitHub リポジトリの URL）、または Install を使用します
• Install this mcp server tavily-ai/tavily-mcp
• Install mcp server with a Brave Github link search result.
• Repair the brave mcp server.
• Update all installed mcp servers. まだ動作しません
• Uninstall Brave 名前が「server-brave-search」の場合でも検索して見つけられます

注：LLM とツールの機能によっては、MCP を呼び出すために、次の2つの語をよく使うと効果的な場合があります。Install、repair、fix、search mcp servers.

---

プラットフォームのテスト

このツールは、問題のある NPX のインストールを修正するため、主に Windows 上で開発・テストされてきました。クロスプラットフォームで動作するように設計されていますが、すべてのオペレーティングシステムでテストすることは難しい状況です。

Mac と Linux でのテスト： すべてのプラットフォームとの互換性を確保するため、Mac と Linux のユーザーからのフィードバックをお待ちしています。macOS または Linux ディストリビューションでこのツールを使用している場合は、以下にご協力ください。

• 発生した問題を GitHub Issues で報告してください
• オペレーティングシステムのバージョンと環境の詳細を明記してください
• プラットフォーム固有の改善案も歓迎します
• 知識や経験がある場合は、プラットフォーム固有の修正への貢献をご検討ください

皆さまからのフィードバックは、このツールがすべてのオペレーティングシステムで円滑に動作するようにするうえで、非常に重要です。

LLM での MCP サーバーの最適な使用方法

さまざまな MCP サーバーでの広範なテストを通じて、小規模なモデルが関数呼び出しを使う場合も含め、LLM が MCP サーバーとやり取りするための最適な方法を見つけました。より良い結果を得るために、MCP クライアントに追加することをおすすめするコンテキストを以下に示します。

Every time you use a MCP server (Model Context Protocol), you must give the complete information. If, for example, you are asked to do a search on anything (YouTube, Wikipedia, Internet, BRAVE, etc.), you must give as much information as possible on the title, description and links. The links are very important in the answer because it can be used later in the conversation, for follow-up interactions with the MCP Client or others MCP servers.

At the beginning of each answer but only if it's a complex question, make a bullet list to summarize what you are going to do between 5 and 10 points of what you will do next.

After your answer, if it's a complex question, always write a resume and a plan to follow at the end of the answer.

Use MCP server tools to go deeper when it's a structured work to do according the the complexity of the task.

For example, if the user asks something very simple like, "hello, how are you?" You don't have to do deep research and just answer normally, without task, without going deeper. Just answer directly.

この実装の完全な例については、こちらの Github Gist をご覧ください。

---

インストールの流れ

graph TD
    A[Parse User Input] --> B{URL Type?}
    B -->|GitHub shorthand| C[Construct full URL]
    B -->|Full URL| D[Clone Repository]
    C --> D
    D --> E[Install Dependencies]
    E --> F[Build Project]
    F --> G[Locate index.js]
    G --> H[Generate MCP Config]
    H --> I[Update Settings]

---

コントリビューション

1. リポジトリをフォークします。
2. 新しいブランチを作成します。
3. 変更を加えます。
4. プルリクエストを送信します。
5. または、Issues セクションから提案を送ったり、協力したりするだけでも構いません。

---

ライセンス

MIT