MCPort

MCPortは、AIを通じてプロジェクトを操作するためのローカルファーストのMCPツールです。AIクライアントがコードの読み取り、ファイルの検索、シンボルの理解、Gitの調査、ファイルの編集、そして明示的に承認された場合には、選択したWorkspace内で制御された開発コマンドを実行できます。

プロジェクトファイル、実行時状態、認証情報はデフォルトでお使いのマシンに保持されます。MCPをローカルで使用するか、選択したWorkspaceに対してパブリックインターネット経由のOAuth/Bearer Tokenアクセスを有効にできます。

中国語の説明：README.zh-CN.md

機能

• プロジェクトファイル、ソースコード、画像、ディレクトリの読み取りと検索

• コードインデックスに加え、定義、参照、Hover、ドキュメントシンボルのサポート

• Gitのステータス、差分、履歴、blame

• 制限されたファイルの作成、編集、インポート、コピー、移動、削除

• ファイル変更のチェックポイント、タスク、検証、リカバリ

• 許可リスト、タイムアウト、出力制限、ローカル確認による制御されたコマンド実行

• 1つ以上のWorkspaceへのローカルまたはパブリックなMCPアクセス

• 言語ごとのLSPインストールと更新、カスタムサーバーのサポート

Related MCP server: Project Navigator MCP Server

AIクライアントの接続

MCPortで、Projects の下にプロジェクトを追加し、WorkspaceのMCPを有効にして、接続情報をコピーします。コピーしたMCPアドレスをAIクライアントのMCP設定に追加します。パブリックアクセスの場合は、Workspaceのパブリックアドレスと、設定済みのOAuthまたはBearer Token認証を使用します。

MCPをサポートする一般的なクライアントには、Claude Desktop、Cursor、Windsurf、Cline、Continue、その他のMCP互換クライアントがあります。設定の場所や構成形式はクライアントによって異なります。クライアントの最新のMCPドキュメントに従い、MCPortが提供するアドレスまたは構成を貼り付けてください。

LSPをインストールまたは更新した後、AIクライアントに server_info を再度呼び出すよう依頼すると、利用可能な言語機能を更新できます。

macOSのインストール

現在のmacOSリリースは署名されていません。MCPort.app を /Applications にドラッグした後、次を実行します：

xattr -dr com.apple.quarantine "/Applications/MCPort.app"

SHA256SUMS.txt を検証した後、公式ダウンロードの場合のみこれを行ってください。

接続

ローカルアクセスはデフォルトでループバックリクエストを受け入れます。パブリックアクセスでは、Cloudflare Tunnel、TryCloudflare、FRP Client、または外部トンネルを使用でき、OAuth（推奨）またはBearer Token認証を使用します。

パブリックWorkspaceは次のようなルートを使用します：

https://mcp.example.com/w/<workspace>/mcp

ファイル、コード、LSP

ファイル操作は、realpathとシンボリックリンクのチェック後、選択したWorkspace内に留まります。組み込みのコードインデックスは、TypeScript、TSX、JavaScript、JSX、MJS、CJSをサポートします。

言語サーバーは個別に管理され、必要に応じてインストールまたは更新できます。サポートされる言語には、TypeScript/JavaScript、HTML、CSS/SCSS/LESS、Python、JSON、YAML、Markdown、Go、Rust、Java、C、C++、PHPが含まれます。他の言語にはカスタムLSP定義を追加できます。

権限レベル

• readonly：プロジェクトの閲覧、検索、コード理解、読み取り専用Git、履歴

• standard：ファイル変更、インポート、チェックポイント、タスク、クイック検証

• full：制御されたコマンド、コマンドセッション、リカバリ、完全な検証

コマンドは実行可能ファイル名と引数配列を使用し、任意のシェル文字列は使用しません。コマンドは、グローバルコマンドスイッチ、完全一致の許可リスト、タイムアウト、出力制限、高リスク確認の対象となります。

セキュリティ

Workspaceの境界は、実パスとシンボリックリンクを解決した後にチェックされます。ファイル変更はSHA256ベースライン、トランザクションロールバック、チェックポイントをサポートします。パブリックWorkspaceでは常に認証が必要です。トークン、トンネル認証情報、その他のシークレットはシステムのセキュアストレージを使用し、ログとトレースからは編集（マスク）されます。

Runtimeはログイン中のOSユーザーとして実行されます。コマンド許可リストはオペレーティングシステムのサンドボックスではありません。

ドキュメント

• デスクトップガイド

• AIクライアントガイド

• MCPツール

• LSPガイド

• セキュリティ

• パブリックゲートウェイとOAuth

• ツールと権限

• リリースガイド

コントリビューション

MCPortはSkyによってメンテナンスされ、MIT Licenseの下でリリースされています。Issueとプルリクエストを歓迎します。CONTRIBUTING.md、SECURITY.md、CODE_OF_CONDUCT.md、プライバシーノート、サードパーティ通知を参照してください。

サードパーティのLSPは、それぞれの公式パッケージマネージャーまたはリリースチャネルからインストールされ、MCPortにはバンドルされていません。各プロジェクトのライセンスと利用規約に従ってください。