MCP Servers for Coders

コーダー向け MCP サーバー

Claude のような AI アシスタントがローカル環境と連携し、コードを実行し、Web コンテンツを処理できるようにする、強力な Model Context Protocol（MCP）サーバースイートです。

概要

このリポジトリには、Claude のような AI アシスタントの機能を大幅に拡張する、複数の Model Context Protocol（MCP）サーバーが含まれています。

1. ファイルシステム MCP サーバー - 高度な差分追跡とバージョン管理を備えた、安全なファイル操作を実現します
2. 実行 MCP サーバー - 隔離された環境でのコマンド実行と、複数言語のスクリプト実行を提供します
3. Web 処理 MCP サーバー - Web コンテンツの取得、クロール、AI を活用したコンテンツ分析を可能にします

これらのサーバーは個別にも組み合わせても動作し、セキュリティを損なうことなく、ローカル環境で複雑なタスクを直接実行するために必要なツールを AI アシスタントに提供します。

サーバー

1. ファイルシステム MCP サーバー

AI アシスタントがローカルファイルを操作できるようにする、安全な Python サーバーです。ファイル管理とコード分析のための包括的な機能を備えています。

• 高度なファイル操作：複数のアクセス方法（ファイル全体、行範囲、キーワードベース）を使ってファイルを読み書きします
• インテリジェントなコード分析：複数の言語にわたって、コードの構造を解析し理解します
• バージョン管理：差分ベースの編集と選択的な承認／却下機能により、AI が加えたすべての変更を追跡します
• セキュリティを最優先した設計：パスの検証、ディレクトリの制限、権限の確認を行います
• Git との連携：.gitignore ルールを尊重した、Git を考慮したディレクトリ一覧を表示します
• エディターとの連携：ワークフローにシームレスに統合できる Neovim プラグインを提供します

主なセキュリティ機能：操作は、パスの完全な検証を伴い、明示的に許可されたディレクトリ内に厳密に制限されます。

ファイルシステム MCP サーバーの詳細

2. 実行 MCP サーバー

AI アシスタントが隔離されたコンテナ内でコードやコマンドを実行できる、強力な実行環境です。

• 複数言語のサポート：Python、JavaScript、Rust、Go、Solidity のコードを実行します
• スマートなパッケージ管理：パッケージマネージャーを横断して、必要な依存関係を自動検出してインストールします
• 実行制御：タイムアウトを設定し、出力ストリームをリダイレクトし、長時間実行されるプロセスを処理します
• 完全な開発環境：複数のプログラミング言語向けに、事前設定済みの環境を提供します
• セキュリティ制御：実行範囲とリソース制限を設定できます

付属の開発環境：

• Python 3.12：データサイエンス用の完全なスタック（pandas、numpy、matplotlib）と開発ツール（black、pytest）
• JavaScript/TypeScript：npm と yarn を備えた Node.js v20
• Rust：rustup、cargo、拡張機能を含む完全なツールチェーン
• Go 1.22.1：標準ツールチェーンと一般的なライブラリ
• Solidity：forge、cast、anvil を含む Foundry スイート

実行 MCP サーバーの詳細

3. Web Processing MCP サーバー

AI アシスタントがインターネットから情報を収集し、処理できるようにする、高度なウェブコンテンツ取得・分析システムです。

• 柔軟なコンテンツ取得：設定可能なパラメーターを使って、単一のページを取得したり、ウェブサイト全体をクロールしたりできます
• インテリジェントなクロール：深度、ページ数の上限、ドメイン制限、タイムアウトを制御できます
• AI による分析：カスタマイズ可能な指示を使用して、OpenAI モデルでウェブコンテンツを処理できます
• 複数の出力形式：結果を Markdown、HTML、テキスト、JSON、または Raw 形式に変換できます
• 堅牢なエラー処理：タイムアウト、リダイレクト、接続の問題を適切に処理します
• コンテンツ処理：サイズ制限と切り詰め処理により、大きなページを自動的に処理します

主な機能：ウェブスクレイピングと AI 分析をシームレスに組み合わせ、生のウェブコンテンツを構造化された有用な情報に変換します。

Web Processing MCP サーバーの詳細

はじめに

インストール

すべてのサーバーは、ほとんどのユーザーに推奨される方法として、Docker によるインストールに対応しています。各サーバーの README には、別のインストール方法も記載されています。

Docker によるインストール（推奨）

# Clone the repository
git clone https://github.com/0kenx/mcp-servers.git
cd mcp-servers

# Build the Filesystem MCP server
cd filesystem
docker build . -t mcp/filesystem

# Build the Exec MCP server
cd ../exec
docker build . -t mcp/exec

# Build the Web MCP server
cd ../web
docker build . -t mcp/web

Claude の設定

Claude Desktop またはその他の Claude インターフェースでこれらの MCP サーバーを使用するには、設定ファイルに追加してください。

{
  "mcpServers": {
    "filesystem": {
      "command": "docker",
      "args": [
          "run",
          "-i",
          "--rm",
          "--mount",
          "type=bind,src=/home/username/projects,dst=/fs",
          "mcp/filesystem",
          "/fs"
      ]
    },
    "exec": {
      "command": "docker",
      "args": [
          "run",
          "-i",
          "--rm",
          "--mount",
          "type=bind,src=/home/username/projects,dst=/fs",
          "mcp/exec",
          "/fs"
      ]
    },
    "web": {
      "command": "docker",
      "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "OPENAI_API_KEY",
          "-e",
          "BRAVE_API_KEY",
          "mcp/web"
      ],
      "env": {
        "OPENAI_API_KEY": "sk-YOUR_OPENAI_KEY",
        "BRAVE_API_KEY": "YOUR_BRAVE_KEY"
      }
    }
  }
}

インストールの確認

設定後、サーバーが正常に動作していることを確認します。

1. Claude を起動し、インターフェースで MCP サーバーを有効にします
2. 基本的なコマンドで各サーバーをテストします：
   • Filesystem：ディレクトリ内のファイル一覧を表示するよう Claude に依頼します
   • Exec：echo "Hello, World!" のような簡単なコマンドを実行するよう Claude に依頼します
   • Web：URL からコンテンツを取得するよう Claude に依頼します

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

これらの MCP サーバーは AI アシスタントに強力な機能を提供するため、セキュリティに十分な注意を払う必要があります。

Filesystem サーバー

• パスの検証：ディレクトリトラバーサル攻撃を防ぎ、操作を許可されたディレクトリに制限します
• 権限の確認：既存のシステムファイル権限を尊重します
• シェル実行なし：コマンドインジェクションの脆弱性を回避します
• 変更の追跡：すべての変更が記録され、元に戻すことができます

Exec サーバー

• 分離：サンドボックス環境またはコンテナー内での実行を検討してください
• リソース制限：不正使用を防ぐため、コンテナーのリソース制限を設定してください
• ネットワーク制限：信頼できないコードを実行する場合は、ネットワークアクセスを制限してください
• 重要なコマンドの確認：システムを変更する操作には注意してください

Web サーバー

• API キーのセキュリティ：OpenAI API キーを保護し、使用状況を監視してください
• ドメイン制限：意図しないクロールを防ぐため、allowed_domains パラメーターを使用してください
• レート制限：ウェブサイトをクロールする際は、レート制限に注意してください

一般的な推奨事項：機密性の高い環境では、最小限の権限を付与した分離コンテナー内でこれらのサーバーを実行し、AI アシスタントの操作を慎重に確認してください。

ユースケース

これらの MCP サーバーを使うと、Claude やその他の AI アシスタントで高度なタスクを実行できます。

ソフトウェア開発

• 大規模なコードベース全体のコード分析とリファクタリング
• 仕様に基づく機能の実装
• テストの実行とログの分析による問題のデバッグ
• 開発環境と依存関係のセットアップ

データ分析

• データの取得、処理、可視化
• ローカルデータセットに対する分析スクリプトの実行
• 情報収集のためのウェブソースのクロール
• 複数のソースからのレポート作成

システム管理

• 診断コマンドの実行と問題の報告
• ソフトウェアパッケージのインストールと設定
• ファイルとディレクトリの安全な管理
• ログとシステム状態の分析

コントリビューション

コントリビューションを歓迎します。お気軽に Pull Request を送信してください。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。

作者

0kenx - GitHub