MCP Proxy Sidecar

🚀 MCP 代理侧边车

このプロジェクトは @dortegau によって作成された JetBrains MCP Server のフォークで、WebSocket 監視機能を追加しています。JetBrains MCP Server の機能を拡張し、WebSocket サポートを追加すると同時に、元の実装のすべての機能との互換性を維持しています。

🚀 クイックスタート

このセクションでは、MCP 代理サイドカーのインストール、起動、開発、貢献、およびリリースの手順を説明します。

インストール

pnpm install mcp-proxy-sidecar

起動

pnpm start

開発要件

• Node.js: Node.js 20.x が必要です。
• 依存関係管理: pnpm (最新バージョン) を使用します。

ビルド手順

1. 依存関係のインストール:

   pnpm install --frozen-lockfile
   

2. プロジェクトのビルド:

   pnpm build
   

貢献方法

1. リポジトリのフォーク: まずこのリポジトリをフォークします。
2. 機能ブランチの作成: あなたの機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更のコミット: あなたの変更をコミットします (git commit -m 'いくつかの素敵な機能を追加')。
4. ブランチへのプッシュ: ブランチをリモートリポジトリにプッシュします (git push origin feature/amazing-feature)。
5. Pull Request の作成: Pull Request を提出します。

リリース方法

このパッケージは npm を通じて公開されます。新しいバージョンを公開するには、以下の手順を実行します。

1. package.json のバージョン番号を更新します。
2. バージョンに一致する新しいタグを作成してプッシュします。
3. タグから GitHub リリースを作成します。
4. ワークフローが自動的にパッケージをビルドし、npm に公開します。

✨ 主な機能

• 初期フォーク: @jetbrains/mcp-proxy の基本実装をベースにしています。
• WebSocket サポート: リアルタイムのツール呼び出し監視機能を実装しています。
• 明確なアーキテクチャ: 元の実装のすべての機能を維持しながら、新しい機能を拡張しています。

WebSocket メッセージ形式

interface WindowToFrontend {
    type: 'frontend-ready' | 'backend-ready' | 'proxy-connected';
}

interface ToBackendMessage {
    type: 'initialize' | 'get-configuration' | 'set-configuration';
    data?: unknown;
}

interface ConfigurationKey extends PropertyKey {}

設定オプション

📚 ドキュメント

アーキテクチャ

graph LR
    A[MCP クライアント<br>例: Claude<br>デスクトップアプリケーション]
    B[MCP プロキシ<br>サイドカー<br>WebSocket 付き]
    C[JetBrains IDE]
    D[WebSocket クライアント<br>監視]
    
    A <--MCP リクエスト/レスポンス--> B
    B <--IDE コマンド/レスポンス--> C
    B --WebSocket 通知<br>ポート 27042--> D

アーキテクチャ図の説明

• A: MCP クライアントを表し、例えば Claude デスクトップアプリケーションです。
• B: WebSocket 機能を備えた MCP プロキシサイドカーを表します。
• C: JetBrains IDE を表します。
• D: 監視用の WebSocket クライアントを表します。

📄 変更履歴

1.0.0

• @jetbrains/mcp-proxy からの初期フォーク
• WebSocket サポートの追加によるリアルタイムツール呼び出し監視の実装
• パッケージ名の変更による明確化
• ドキュメントと設定例の更新

📄 ライセンス

このプロジェクトは Apache 2.0 ライセンスの下で公開されています。詳細については、こちら を参照してください。

謝辞

このプロジェクトは JetBrains MCP Proxy Server のフォークです。元の実装のすべてのクレジットは JetBrains チームに帰属します。