# リポジトリのクローン
git clone https://github.com/tomohirof/verge-mcp-server.git
cd verge-mcp-server

# 依存関係のインストール
npm install

# ビルド
npm run build

cp .env.example .env

# Plume API URL
VERGE_API_URL=https://api.vergecms.io

# 認証情報（オプション: ブラウザ認証を使う場合は不要）
VERGE_EMAIL=your-email@example.com
VERGE_PASSWORD=your-password

{
  "mcpServers": {
    "plume": {
      "command": "node",
      "args": ["/absolute/path/to/verge-mcp-server/dist/index.js"],
      "env": {
        "VERGE_API_URL": "https://api.vergecms.io"
      }
    }
  }
}

あなた: "ブログを作成してください。名前は『Tech Blog』です"
→ verge_create_blogツールが実行され、ブログが作成されます

あなた: "先ほど作成したブログに新しい記事を書いてください"
→ verge_create_articleツールが実行され、記事が作成されます

あなた: "記事を公開してください"
→ verge_publish_articleツールが実行され、記事が公開されます

1. ブラウザ自動起動
   ↓
   MCPサーバーが認証用URLでブラウザを自動的に開きます

2. ユーザー承認
   ↓
   ブラウザでVergeCMSにログインし、MCPサーバーへのアクセスを承認

3. トークン永続化
   ↓
   認証トークンが安全にローカルに保存され、次回以降自動的に使用されます

// Claude Desktopで以下のように実行
"VergeCMSにログインしてください"

// 自動的にブラウザが起動し、認証フローが開始されます
// 一度認証すれば、トークンが保存され、次回以降は自動ログイン

VERGE_EMAIL=your-email@example.com
VERGE_PASSWORD=your-password

{
  email?: string;     // メールアドレス（オプション: 省略時はブラウザ認証）
  password?: string;  // パスワード（オプション）
}

{
  success: true,
  token: "eyJhbGc...",
  user: {
    id: 1,
    email: "user@example.com",
    name: "John Doe"
  }
}

{
  id: 1,
  email: "user@example.com",
  name: "John Doe",
  created_at: "2024-01-01T00:00:00Z"
}

{
  user_id: number;    // ユーザーID
  name?: string;      // 新しい名前
  email?: string;     // 新しいメールアドレス
  password?: string;  // 新しいパスワード
}

[
  {
    id: 1,
    name: "Tech Blog",
    title: "技術ブログ",
    slug: "tech-blog",
    description: "技術記事を書くブログ"
  }
]

{
  blog_id: number;  // ブログID
}

{
  name: string;          // ブログ名（必須）
  title: string;         // タイトル（必須）
  slug: string;          // URLスラッグ（必須）
  description?: string;  // 説明（オプション）
}

// Claude Desktopでの使用例
"新しいブログを作成してください。
 名前: 'My Tech Blog'
 タイトル: '技術ブログ'
 スラッグ: 'tech-blog'
 説明: '最新の技術トレンドを発信するブログ'"

{
  blog_id: number;       // ブログID（必須）
  name?: string;         // 新しい名前
  title?: string;        // 新しいタイトル
  slug?: string;         // 新しいスラッグ
  description?: string;  // 新しい説明
}

{
  blog_id: number;  // ブログID
}

{
  blog_id: number;                      // ブログID（必須）
  search?: string;                      // 検索キーワード
  status?: 'draft' | 'published';       // ステータスフィルタ
  category_ids?: number[];              // カテゴリIDでフィルタ
  tag_ids?: number[];                   // タグIDでフィルタ
}

// 公開済み記事のみを取得
{
  blog_id: 1,
  status: 'published'
}

// キーワード検索
{
  blog_id: 1,
  search: 'TypeScript'
}

{
  article_id: number;  // 記事ID
  blog_id: number;     // ブログID
}

{
  blog_id: number;                      // ブログID（必須）
  title: string;                        // タイトル（必須）
  content: string;                      // 本文（必須、Markdown）
  slug: string;                         // URLスラッグ（必須）
  status?: 'draft' | 'published';       // ステータス（デフォルト: draft）
  featured_image?: string;              // アイキャッチ画像URL
  excerpt?: string;                     // 抜粋
  author_id?: number;                   // 著者ID
  category_ids?: number[];              // カテゴリID配列
  tag_ids?: number[];                   // タグID配列
}

// Claude Desktopでの使用例
"新しい記事を作成してください。
 ブログID: 1
 タイトル: 'TypeScriptでMCPサーバーを作る'
 スラッグ: 'typescript-mcp-server'
 内容: '# はじめに\n\nこの記事では...'"

{
  article_id: number;                   // 記事ID（必須）
  blog_id: number;                      // ブログID（必須）
  title?: string;                       // 新しいタイトル
  content?: string;                     // 新しい本文
  slug?: string;                        // 新しいスラッグ
  status?: 'draft' | 'published';       // 新しいステータス
  featured_image?: string;              // 新しいアイキャッチ画像
  excerpt?: string;                     // 新しい抜粋
  author_id?: number;                   // 新しい著者ID
  category_ids?: number[];              // 新しいカテゴリID配列
  tag_ids?: number[];                   // 新しいタグID配列
}

{
  article_id: number;  // 記事ID
  blog_id: number;     // ブログID
}

{
  article_id: number;  // 記事ID
  blog_id: number;     // ブログID
}

# 全テスト実行
npm test

# テストUI起動
npm run test:ui

# カバレッジ測定
npm run test:coverage

# TypeScriptを直接実行（開発モード）
npm run dev

# MCPインスペクター（ツールの動作を検証）
npm run inspector

# ビルド
npm run build

# 型チェック
npx tsc --noEmit

# Lint
npm run lint

verge-mcp-server/
├── src/
│   ├── index.ts                    # MCPサーバーエントリーポイント
│   ├── server.ts                   # MCPサーバーコア実装
│   ├── config.ts                   # 環境変数管理
│   ├── auth/
│   │   ├── index.ts                # 認証フロー統合
│   │   ├── browser-auth.ts         # ブラウザ認証フロー
│   │   └── token-storage.ts        # トークン永続化
│   ├── client/
│   │   ├── types.ts                # Zodスキーマ・型定義
│   │   ├── errors.ts               # カスタムエラークラス
│   │   └── api.ts                  # Plume APIクライアント
│   └── tools/
│       ├── schemas.ts              # MCPツール入力スキーマ
│       ├── auth.ts                 # 認証ツールハンドラー
│       ├── blogs.ts                # ブログ管理ツールハンドラー
│       └── articles.ts             # 記事管理ツールハンドラー
├── tests/
│   ├── client/
│   │   ├── types.test.ts           # Zodスキーマテスト（43テスト）
│   │   ├── api.test.ts             # APIクライアントテスト（21テスト）
│   │   ├── api-retry.test.ts       # リトライ機能テスト（11テスト）
│   │   ├── api-backoff.test.ts     # バックオフテスト（7テスト）
│   │   ├── api-timeout.test.ts     # タイムアウトテスト（5テスト）
│   │   └── errors.test.ts          # エラーハンドリングテスト（11テスト）
│   ├── tools/
│   │   ├── auth.test.ts            # 認証ツールテスト（6テスト）
│   │   ├── blogs.test.ts           # ブログ管理ツールテスト（10テスト）
│   │   └── articles.test.ts        # 記事管理ツールテスト（8テスト）
│   └── integration/
│       ├── server.e2e.test.ts      # E2Eテスト（6テスト）
│       ├── error-handling.test.ts  # エラーハンドリング統合テスト（8テスト）
│       └── articles.scenario.test.ts # 記事管理シナリオテスト（3テスト）
├── dist/                           # ビルド出力
├── package.json
├── tsconfig.json
├── vitest.config.ts
└── README.md

# トークンファイルを削除
rm ~/.verge-mcp-token.json

# Claude Desktopを再起動し、再度ログインを実行

# node_modulesを削除して再インストール
rm -rf node_modules
npm install

# ビルド
npm run build