Gooseworks MCP

Expressサーバーで、Model Context Protocol (MCP) Streamable HTTP トランスポートを通じてツールを公開します。GitHubツールのセットも含まれています。

MCPエンドポイントは次のとおりです:

http://localhost:4000/mcp

すべてのリクエストには、MCP_AUTH_TOKEN で設定されたベアラートークンを含める必要があります。

必要条件

• Node.js v25.2.1

• pnpm 11.5.3

• コンテナデプロイ用のDocker EngineとDocker Compose v2

• 使用予定のツールに必要な権限を持つGitHub個人アクセストークン

Related MCP server: GitHub MCP Agent Server

設定

サーバーはローカルの.envファイルまたはプロセス環境から変数を読み込みます:

テンプレートからローカル環境ファイルを作成します:

cp .env.template .env

.envを編集し、両方のプレースホルダートークン値を置き換えます。MCP_AUTH_TOKENには長くランダムに生成された値を使用し、GitHubトークンにはこのサーバーに必要な権限のみを付与します。.envをコミットしたり、いずれかのトークンを公開Issue、ログ、画像に貼り付けたりしないでください。

ローカルでの実行

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

   pnpm install

2. 上記の通り.envを作成し設定します。

3. サーバーを起動:

   pnpm start

   これはpnpm exec tsx src/index.tsと同じエントリポイントを実行します。

ソース変更後に自動再起動する開発用には、次を使用します:

pnpm dev

ファイルを出力せずにTypeScriptプロジェクトをチェックするには:

pnpm typecheck

コンソールにhttp://localhost:<PORT>/mcpでアクティブであると表示されたら、サーバーの準備は完了です。MCPクライアントがそのURLを使用し、次のように送信するよう設定します:

Authorization: Bearer <MCP_AUTH_TOKEN>

Docker Composeでのデプロイ

1. ホストにDocker EngineとDocker Compose v2をインストールします。

2. このリポジトリをクローンし、そのディレクトリに移動します:

   git clone <repository-url>
   cd gooseworks-mcp

3. デプロイ環境ファイルを作成します:

   cp .env.template .env

4. .envにGITHUB_TOKENと強力で秘密のMCP_AUTH_TOKENを設定します。サービスが異なるホスト/コンテナポートでリッスンする場合はPORTを設定します。同じ値がComposeのポートマッピングの両側で使用されます。

5. サービスをビルドし、バックグラウンドで起動します:

   docker compose up --build -d

6. サービスのログを追跡するか、必要に応じて停止します:

   docker compose logs -f gooseworks-mcp
   docker compose down

Compose設定は、サポートされている3つの変数をコンテナに渡し、必要なトークンのいずれかが欠けている場合は早期に失敗します。公開デプロイの場合は、サービスをHTTPSリバースプロキシの背後に配置し、可能であればポート4000または選択したPORTを非公開に保ちます。MCPクライアントはプロキシのHTTPS /mcp URLと設定されたベアラートークンを使用する必要があります。

利用可能なツール

サーバーは以下のツールを登録します:

GitHub

• 認証済みプロファイルの読み取り

• リポジトリ、ブランチ、コミットの一覧表示

• コードの検索

• ファイル内容の読み取り

• Issueの作成

• プルリクエストの作成

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。ライセンス条件に従い、あらゆる目的で自由に使用、フォーク、変更、再配布することができます。