mcp-proxy-server

mcp-proxy-server

複数のバックエンド MCP サーバーへの接続を可能にする、Model Context Protocol（MCP）用のプロキシサーバーです。

はじめに

インストール

グローバルインストール

パッケージをグローバルにインストールします。

npm install -g @pyleeai/mcp-proxy-server

ライブラリとして

プロジェクトにインストールします。

npm install @pyleeai/mcp-proxy-server

使い方

グローバルにインストールした場合：

mcp-proxy-server

設定

MCP Proxy Server は、環境変数を使用して設定できます。

CONFIGURATION_URL="http://example.com/configuration"
LOG_PATH=./logs/mcp-proxy-server.log

環境変数

• CONFIGURATION_URL は必須です。
• LOG_PATH は任意です。

設定 JSON

CONFIGURATION_URL は、プロキシサーバーの設定を含む JSON を指します。次の構造にしてください。

{
    "mcp": {
        "servers": {
            "fetch": {
                "args": [
                    "mcp-server-fetch"
                ],
                "command": "uvx"
            },
            "filesystem": {
                "args": [
                    "-y",
                    "@modelcontextprotocol/server-filesystem",
                    "."
                ],
                "command": "npx"
            }
        }
    }
}

コントリビューション

コントリビューションを歓迎します！このプロジェクトには、次の方法で貢献できます。

前提条件

• Bun v1.2.2 以降

セットアップ

1. リポジトリをクローンします。

git clone https://github.com/your-username/mcp-proxy-server.git
cd mcp-proxy-server

2. 依存関係をインストールします。

bun install

使い方

サーバーの実行

サーバーを起動します。

bun start

スクリプト

このプロジェクトには、開発に役立つ npm スクリプトがいくつか用意されています。

• bun lint - Biome を使用してコードベースをリントします
• bun format - Biome を使用してコードベースをフォーマットします
• bun check - リントとフォーマットの両方をチェックします
• bun typecheck - 出力を生成せずに TypeScript の型をチェックします
• bun test - すべてのテストを実行します
• bun start - 開発サーバーを起動します
• bun build - プロジェクトをビルドします
• bun inspector - MCP inspector ツールを実行します

コードスタイル

このプロジェクトでは、コードのフォーマットとリントに Biome を使用しています。次を実行して、コードがこれらの基準に従っていることを確認してください。

bun check

テスト

このプロジェクトでは、包括的なテストを行うために Bun 組み込みのテストランナーを使用しています。

テストの実行

# Run all tests
bun test

# Run tests with watch mode (auto-rerun on file changes)
bun test --watch

# Run tests with coverage reporting
bun test --coverage

テストの構成

テストスイートは test ディレクトリに整理されており、次のサブディレクトリがあります。

• test/unit - 個々のコンポーネントのユニットテスト
• test/integration - 複数のコンポーネントを組み合わせた統合テスト

公開

Bun を使用して npm にパッケージを公開する手順は次のとおりです。

1. package.json のバージョンを更新します。

bun run npm version [patch|minor|major]

2. パッケージをビルドします。

bun run build

3. npm に公開します。

bun publish

npm の認証情報と適切なアクセス権が必要です。

リリースプロセス

このプロジェクトでは、リリースの作成と公開に GoReleaser を使用しています。

GoReleaser の設定

リリースプロセスは .goreleaser.yaml で定義されており、次の内容が含まれます。

• 複数のプラットフォーム（Linux、macOS、Windows）向けのビルド
• x64 と arm64 の両方のアーキテクチャへの対応
• 配布可能なアーカイブの作成
• 変更履歴の生成
• GitHub リリースの作成

リリースの作成

1. 新しいバージョンにタグを付けます。

git tag -a v1.0.0 -m "Release v1.0.0"

2. タグをプッシュします。

git push origin v1.0.0

3. CI/CD パイプラインによって、次の処理が自動的に行われます。
   • すべての対象プラットフォーム向けにビルド
   • 配布用アーカイブの作成
   • 変更履歴の生成
   • GitHub でのリリース公開