Gooseworks MCP
Gooseworks MCP
Expressサーバーで、Model Context Protocol (MCP) Streamable HTTP トランスポートを通じてツールを公開します。GitHubツールのセットも含まれています。
MCPエンドポイントは次のとおりです:
http://localhost:4000/mcpすべてのリクエストには、MCP_AUTH_TOKEN で設定されたベアラートークンを含める必要があります。
必要条件
Node.js
v25.2.1pnpm
11.5.3コンテナデプロイ用のDocker EngineとDocker Compose v2
使用予定のツールに必要な権限を持つGitHub個人アクセストークン
Related MCP server: GitHub MCP Agent Server
設定
サーバーはローカルの.envファイルまたはプロセス環境から変数を読み込みます:
変数 | 必須 | デフォルト | 説明 |
| いいえ |
| HTTPサーバーがリッスンするポート |
| はい | なし | Octokitで使用するGitHub個人アクセストークン |
| はい | なし | すべてのMCPリクエストに必要なベアラートークン |
テンプレートからローカル環境ファイルを作成します:
cp .env.template .env.envを編集し、両方のプレースホルダートークン値を置き換えます。MCP_AUTH_TOKENには長くランダムに生成された値を使用し、GitHubトークンにはこのサーバーに必要な権限のみを付与します。.envをコミットしたり、いずれかのトークンを公開Issue、ログ、画像に貼り付けたりしないでください。
ローカルでの実行
依存関係をインストール:
pnpm install上記の通り
.envを作成し設定します。サーバーを起動:
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でのデプロイ
ホストにDocker EngineとDocker Compose v2をインストールします。
このリポジトリをクローンし、そのディレクトリに移動します:
git clone <repository-url> cd gooseworks-mcpデプロイ環境ファイルを作成します:
cp .env.template .env.envにGITHUB_TOKENと強力で秘密のMCP_AUTH_TOKENを設定します。サービスが異なるホスト/コンテナポートでリッスンする場合はPORTを設定します。同じ値がComposeのポートマッピングの両側で使用されます。サービスをビルドし、バックグラウンドで起動します:
docker compose up --build -dサービスのログを追跡するか、必要に応じて停止します:
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…
This server cannot be deployed
Maintenance
Related MCP Connectors
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
An MCP server that gives your AI access to the source code and docs of all public github repos
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol (MCP) application for automated GitHub PR analysis and issue management.…
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceModel Context Protocol server that enables interaction with GitHub repositories, issues, pull requests, and search functionality through natural language.1-
- AlicenseBqualityCmaintenanceMCP server that exposes GitHub operations as tools for AI agents, enabling code search, issue management, and PR review.12MIT
- AlicenseBqualityDmaintenanceMCP (Model Context Protocol) server for GitHub API integration. This server provides comprehensive tools for interacting with GitHub repositories, issues, pull requests, branches, and code search through a unified interface.158 npmMIT
- FlicenseNot gradedqualityBmaintenanceA GitHub MCP server that wraps the gh CLI to expose GitHub operations like issues, pull requests, branches, labels, repositories, CI actions, and Projects V2 as tools for MCP clients.-