# リポジトリをクローン
git clone https://github.com/nht-x/github-mcp.git
cd github-mcp

# Poetry で依存関係をインストール
poetry install

# .env.example をコピー
cp .env.example .env

# 暗号化キーを生成
python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

# .env を編集（GitHub PAT と暗号化キーを設定）
nano .env

# MCP サーバー起動（stdio トランスポート）
poetry run python -m github_mcp.core.server

github-mcp/
├── 📁 src/github_mcp/
│   ├── 📄 config.py                 # 設定管理
│   ├── 📁 api/
│   │   ├── client.py                # GitHub API クライアント
│   │   ├── exceptions.py            # API 例外定義
│   │   └── __init__.py
│   ├── 📁 core/
│   │   ├── server.py                # MCP サーバー本体
│   │   ├── cli.py                   # CLI エントリーポイント
│   │   └── __init__.py
│   ├── 📁 tools/
│   │   ├── handlers.py              # MCP ツールハンドラー
│   │   └── __init__.py
│   ├── 📁 utils/
│   │   ├── encryption.py            # トークン暗号化（Fernet）
│   │   ├── logging.py               # ログ & トークンマスキング
│   │   └── __init__.py
│   └── 📁 services/
│       └── __init__.py              # GitHub サービスラッパー
├── 📁 tests/
│   ├── unit/                        # ユニットテスト
│   └── integration/                 # 統合テスト
├── .env.example                     # 環境テンプレート
├── pyproject.toml                   # 依存関係
├── DEVELOPMENT.md                   # 開発ガイド
├── README.md                        # このファイル
└── LICENSE                          # MIT License

# 必須
GITHUB_PAT=ghp_...                    # GitHub Personal Access Token
ENCRYPTION_KEY=your_fernet_key        # python -c で生成

# オプション
LOG_LEVEL=INFO                        # DEBUG, INFO, WARNING, ERROR
LOG_FORMAT=text                       # text または json
MCP_SERVER_HOST=127.0.0.1
MCP_SERVER_PORT=8000

{
  "mcpServers": {
    "github": {
      "command": "poetry",
      "args": ["run", "python", "-m", "github_mcp.core.server"],
      "cwd": "/absolute/path/to/github-mcp",
      "env": {
        "GITHUB_PAT": "ghp_...",
        "ENCRYPTION_KEY": "your_fernet_key"
      }
    }
  }
}

openapi: 3.0.0
info:
  title: GitHub MCP API
  version: 1.0.0
servers:
  - url: http://localhost:8000
paths:
  /dispatch:
    post:
      summary: repository_dispatch をトリガー
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                owner:
                  type: string
                repo:
                  type: string
                event_type:
                  type: string
                payload_json:
                  type: string
  /issue:
    post:
      summary: Issue を作成
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                owner:
                  type: string
                repo:
                  type: string
                title:
                  type: string
                body:
                  type: string
  /repository:
    post:
      summary: リポジトリ情報を取得
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                owner:
                  type: string
                repo:
                  type: string

# すべてのテストを実行
poetry run pytest

# カバレッジ付きで実行
poetry run pytest --cov=src/github_mcp

# 特定のテストファイルのみ実行
poetry run pytest tests/unit/test_config.py -v

# フォーマッティング
poetry run black src/

# リント
poetry run ruff check src/

# 型チェック
poetry run mypy src/

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

# .env に GITHUB_PAT が設定されているか確認
cat .env | grep GITHUB_PAT

# 環境変数で直接設定
export GITHUB_PAT=ghp_...

# 依存関係を再インストール
poetry install --no-cache

# 暗号化キーが正しい Fernet キーか確認
python -c "from cryptography.fernet import Fernet; Fernet('your_key')"