Skip to main content
Glama
Gooseworks MCP

Gooseworks MCP

by EduardKuun

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ファイルまたはプロセス環境から変数を読み込みます:

変数

必須

デフォルト

説明

PORT

いいえ

4000

HTTPサーバーがリッスンするポート

GITHUB_TOKEN

はい

なし

Octokitで使用するGitHub個人アクセストークン

MCP_AUTH_TOKEN

はい

なし

すべてのMCPリクエストに必要なベアラートークン

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

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ライセンスの下でライセンスされています。ライセンス条件に従い、あらゆる目的で自由に使用、フォーク、変更、再配布することができます。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers