mcplocal

Local Files MCP serverは、MCP対応クライアント（利用可能な場合はChatGPT WebのカスタムMCPアプリを含む）が、明示的に設定された1つのディレクトリ内のファイルを読み取り、検索、変更できるようにするものです。

Features

• レガシーHTTP+SSE: GET /sse + POST /messages

• モダンなMCP HTTPエンドポイント: /mcp

• ヘルスチェック: /health

• サンドボックス: すべてのファイルパスは MCP_ROOT 配下で解決されます

• オプションのBearer認証

• プロジェクト探索のための読み取り/検索ツール

• コーディングワークフローのための書き込み/編集ツール

• 削除はデフォルトで無効

• シェル/CLI実行ツールなし

• 外部データベースへの依存なし

• Node.js 20+

MCP TypeScript SDKは現在、リモートサーバーにはStreamable HTTPを推奨しており、HTTP+SSEを後方互換性のあるトランスポートとして扱っています。このプロジェクトは、古いSSEクライアントが引き続き接続でき、新しいクライアントが /mcp を使用できるように、意図的に両方を公開しています。

Related MCP server: FilesystemMCP

1. 実行

cp .env.example .env
# edit MCP_ROOT if needed
npm start

例:

MCP_ROOT=~/Projects
MCP_HOST=127.0.0.1
MCP_PORT=8008
MCP_AUTH_TOKEN=change-me

次に:

SSE:        http://127.0.0.1:8008/sse
Streamable: http://127.0.0.1:8008/mcp
Health:     http://127.0.0.1:8008/health

2. ChatGPT Webが接続できるもの

ChatGPT Webはホストされたサービスから localhost に直接到達できません。ローカルMCPサーバーは、サポートされているSecure MCP Tunnel/プライベートネットワークの仕組みを通じて到達可能にする必要があります。リモートMCPエンドポイントを取得したら、ChatGPT Developer ModeでカスタムMCPアプリとして追加し、ツールをスキャンして有効にします。

ローカルサービスをマッピングするトンネルの場合、ローカルオリジンは次のとおりです:

http://127.0.0.1:8008/sse

または、モダンなクライアントの場合:

http://127.0.0.1:8008/mcp

認証と明示的なネットワークポリシーなしに、このサーバーをパブリックインターネットに公開しないでください。

3. ChatGPTに公開されるツール

• list_files(path, recursive)

• read_file(path, startLine, endLine)

• write_file(path, content, createDirs)

• edit_file(path, oldText, newText, replaceAll)

• search_files(query, path, regex, caseSensitive, maxResults)

• create_directory(path)

• file_info(path)

• delete_file(path) は MCP_ENABLE_DELETE=true の場合のみ

一般的なコーディングワークフロー:

1. list_files でプロジェクトを把握する。

2. search_files でシンボルを探す。

3. read_file で関連コードを確認する。

4. edit_file でピンポイントな変更を行うか、write_file で新しいファイルを作成する。

5. read_file をもう一度実行して結果を検証する。

4. セキュリティモデル

MCP_ROOT が厳格な境界です。../ によるトラバーサルや、その外側の絶対パスは拒否されます。バイナリファイルや読み取り不能なファイルは検索でスキップされます。ファイルサイズは MCP_MAX_FILE_BYTES によって上限が設定されます。

このサーバーは意図的に任意のシェル実行を公開していません。つまり、ChatGPTはコードを編集できますが、このMCPを通じて rm、curl、パッケージマネージャー、gitコマンド、または任意のプログラムを自動的に実行することはできません。

開発マシンでは、MCP_HOST=127.0.0.1 のままにし、サーバーをすべてのインターフェースにバインドするのではなく、サポートされているSecure MCP Tunnelを使用してください。

5. ビルド

npm run build
node dist/server.js

ビルドは依存関係がなく、ランタイムを dist/ にコピーします。

6. Docker

docker build -t mcplocal .
docker run --rm -p 8008:8008 -v "$PWD:/workspace" mcplocal

7. ChatGPTでのプロンプト例

Inspect this local project and tell me where the authentication flow is implemented. Do not modify anything.

Open src/server.js and refactor the error handling. Before changing it, read the relevant code. Then edit only the necessary section and show me what changed.

Search the project for TODO comments and create a report at reports/todos.md.

ライセンス

MIT