MCP Cli Github Integration

🚀 GitHub Integration Hub

Cristianによって構築され、OAuthオーケストレーション、安全なトークン保存、SDK/CLIツール、およびMCPサーバーをTypeScriptで実証するためのプロジェクトです。

🚀 クイックスタート

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

npm install

2. 環境の設定

.env.example を .env にコピーし、GitHub OAuthの認証情報を設定します。

PORT=3000
DATABASE_FILE=./github-integration-hub.db
GITHUB_CLIENT_ID=your-client-id
GITHUB_CLIENT_SECRET=your-client-secret
GITHUB_OAUTH_AUTHORIZE_URL=https://github.com/login/oauth/authorize
GITHUB_OAUTH_TOKEN_URL=https://github.com/login/oauth/access_token
GITHUB_API_BASE_URL=https://api.github.com
GITHUB_REDIRECT_URI=http://localhost:3000/auth/github/callback
GITHUB_INTEGRATION_HUB_BASE_URL=http://localhost:3000

GitHub OAuthアプリのリダイレクトURLが GITHUB_REDIRECT_URI と一致していることを確認してください。

3. バックエンドの実行

ホットリロードを使用した開発モード:

npm run dev

本番環境のビルドと実行:

npm run build
npm start

サーバーは次のようにログを出力します: GitHub Integration Hub listening on port <port>.

✨ 主な機能

• (OAuth) /auth/github/start と /auth/github/callback でGitHubの認証フローをラップします。
• (Storage) SQLiteテーブルの自動作成、トークンのリフレッシュスキャフォールディング、およびリポジトリヘルパーを提供します。
• (Services) HTTPルート、CLI、SDK、およびMCPツールで共有されるオーケストレーションロジックを提供します。
• (Tooling) 型安全な IntegrationHubClient SDKと github-integration-hub CLIを提供します。
• (Agents) MCPツール github_start_auth、github_list_repos、および github_create_issue を提供します。

📦 インストール

依存関係のインストール

npm install

環境の設定

.env.example を .env にコピーし、GitHub OAuthの認証情報を設定します。

PORT=3000
DATABASE_FILE=./github-integration-hub.db
GITHUB_CLIENT_ID=your-client-id
GITHUB_CLIENT_SECRET=your-client-secret
GITHUB_OAUTH_AUTHORIZE_URL=https://github.com/login/oauth/authorize
GITHUB_OAUTH_TOKEN_URL=https://github.com/login/oauth/access_token
GITHUB_API_BASE_URL=https://api.github.com
GITHUB_REDIRECT_URI=http://localhost:3000/auth/github/callback
GITHUB_INTEGRATION_HUB_BASE_URL=http://localhost:3000

GitHub OAuthアプリのリダイレクトURLが GITHUB_REDIRECT_URI と一致していることを確認してください。

バックエンドの実行

ホットリロードを使用した開発モード:

npm run dev

本番環境のビルドと実行:

npm run build
npm start

💻 使用例

基本的な使用法

npm run build
npx github-integration-hub connections:list
npx github-integration-hub actions:list-repos --user alice
npx github-integration-hub actions:create-issue --user alice --owner my-org --repo api --title "Hello" --body "Proof from Cristian"

高度な使用法

import { IntegrationHubClient } from 'github-integration-hub/sdk';

const client = new IntegrationHubClient({ baseUrl: process.env.GITHUB_INTEGRATION_HUB_BASE_URL! });

async function showcase() {
  const { authUrl } = await client.startGithubAuth('user-123');
  console.log('Send someone to authorize:', authUrl);

  const repos = await client.listGithubRepos('user-123');
  console.log(repos.map((repo) => repo.full_name));
}

📚 ドキュメント

MCPサーバー (AIエージェント用)

一度コンパイルしてから、stdioサーバーを起動します。

npm run build
npm run start:mcp

利用可能なツール:

• github_start_auth – userId の認証URLを返します。
• github_list_repos – 保存された接続のリポジトリを一覧表示します。
• github_create_issue – 保存されたトークンを使用してイシューを作成します。

MCP対応のIDE/CLI（例: Codex）をこのstdioプロセスに向けると、ツールをすぐに呼び出すことができます。

HTTP APIリファレンス

CLI (github-integration-hub)

npm run build
npx github-integration-hub connections:list
npx github-integration-hub actions:list-repos --user alice
npx github-integration-hub actions:create-issue --user alice --owner my-org --repo api --title "Hello" --body "Proof from Cristian"

フラグ:

• --base-url は GITHUB_INTEGRATION_HUB_BASE_URL を上書きします。
• connections:list --user <userId> はエントリをフィルタリングします。

手動OAuthテストプラン

1. POST /auth/github/start に { "userId": "demo-user" } を送信します。
2. 返された authUrl を訪問し、GitHubアプリを承認します。
3. コールバックで接続が自動的に保存されます。
4. HTTP、CLI、SDK、またはMCPツールを使用してアクションをトリガーします。

🔧 技術詳細

このプロジェクトは、Node.js LTS上でExpress、better-sqlite3、およびTypeScriptを使用して動作します。目的は、以下のことを実証することです。

• 状態管理とトークンの永続化を伴うOAuthフロー（GitHub）を設計すること。
• TypeScriptを使用してSQLite上に軽量なデータレイヤーを構築すること。
• HTTPルート、SDK、CLI、およびAIエージェント用のMCPサーバーを介して同じビジネスロジックを公開すること。

プロジェクト構造

.
|-- cli/               # CLIエントリポイント
|-- sdk/               # TypeScript SDK
|-- src/
|   |-- config/        # 環境ヘルパー
|   |-- db/            # SQLiteの初期化 + リポジトリ
|   |-- mcp/           # MCPサーバー
|   |-- providers/     # GitHub OAuth + APIクライアント
|   |-- routes/        # Expressルーター
|   `-- services/      # トークンマネージャー + アクション
|-- .env.example
|-- package.json
|-- tsconfig.json
`-- README.md

Cristianによって作成されました。 バックエンドの統合、OAuthの設計、またはMCPツールについて話したい場合は、ぜひ連絡してください。