Codify MCP

🚀 Codify MCP

Apify Agentを使用したカスタム自動化ツール用のMCPサーバーです。

Project Codifyの一部です。

🚀 クイックスタート

Project Codifyは、ブラウザ内（またはローカル）で実行される完全なエンドツーエンドのブラウザ自動化パイプラインです。ブラウザのアクションを堅牢（決定論的）かつ再利用可能なスクリプトとしてコード化し、再現することができます。迅速なプロトタイピングや簡単な自動化スクリプトから、大規模な高度なデプロイメントまで対応します。

• ログイン - 再利用可能な認証セッション - 再利用可能な安全なログイン (TBD) ❎
• エージェント - スクリプトをブラウザアクションに変換 - コードまたはテキストスクリプト (将来的に) ✅
• コーダー - ブラウザアクションをスクリプトに変換 (TBD - 現在統合済み) ✅
• ロボット - 拡張性のための自動化エンジン (TBD - 現在統合済み) ✅
• MCP - 自動化をAIを通じて再利用可能なツールに変換 ✅

これからも機能が追加されます... 試してみて 🎬 またはプロジェクトをフォローするためにリストに参加してください！ 🔔

✨ 主な機能

Model Context Protocol (MCP)サーバーは、AIアシスタント（例：Claude、Cursor、VS Code）がApify Agentを介してブラウザ自動化タスクを実行できるようにします。ツールはクリーンなJSON引数として渡され、1行に1つです。手動でのセットアップやファイルの作成は必要ありません。

📦 インストール

直接npxを使用して実行することができます。

npx codify-mcp {{JSON_MCP_TOOL_1}} {{JSON_MCP_TOOL_2}} {{JSON_MCP_TOOL_3}}...

または、ローカルにインストールすることもできます。

npm install -g codify-mcp

💻 使用例

基本的な使用法

1. Apifyトークン

オプションです。後でMCPサーバーのJSON内にトークンを配置することもできます。

apify login

これにより、トークンが~/.apify/auth.jsonに保存されます。

または、環境変数を設定することもできます。

export APIFY_TOKEN="your_token_here"

2. ツールの作成

Apify Coderを使用すると、日常的なブラウザアクションを再利用可能なAIツールに変換することができます。現在、この機能はApify Agentにも統合されています。

ツールをエクスポートし、結果をJSON文字列としてMCPサーバーのargsフィールドに追加するか、AIに依頼して行うことができます。

{
  "name": "scrape_product",
  "description": "Scrape product info from a page",
  "inputSchema": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "description": "Product page URL"
      }
    },
    "required": ["url"]
  },
  "implementation": {
    "type": "apify-actor",
    "actorId": "cyberfly/apify-agent",
    "script": "await page.goto(inputs.url); const title = await page.textContent('h1'); return {title};"
  }
}

3. サーバーの実行

npx codify-mcp '{"name":"scrape_product","description":"...","inputSchema":{...},"implementation":{...}}'

または、複数のツールを使用する場合：

npx codify-mcp \
  '{"name":"tool1",...}' \
  '{"name":"tool2",...}' \
  '{"name":"tool3",...}'

4. Claude Desktop (またはCursor/VS Code)への接続

Claude Desktopの設定を編集します。

macOS/Linux: ~/.config/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "codify-mcp": {
      "command": "npx",
      "args": [
        "codify-mcp",
        "{\"name\":\"scrape_product\",\"description\":\"...\",\"inputSchema\":{...},\"implementation\":{...}}"
      ],
      "env": {
        "APIFY_TOKEN": "your_token_or_leave_empty_to_use_auth_file"
      }
    }
  }
}

Claudeを再起動します。これで、AIアシスタントがツールを使用できるようになります。

高度な使用法

ツール定義のリファレンス

基本構造

{
  // 必須
  "name": "tool_name",                    // 英数字 + アンダースコア/ダッシュ
  "description": "What the tool does",    // AIに表示される説明
  "inputSchema": {
    "type": "object",
    "properties": {
      "paramName": {
        "type": "string",
        "description": "Parameter description"
      }
    },
    "required": ["paramName"]
  },
  "implementation": {
    "type": "apify-actor",
    "actorId": "cyberfly/apify-agent",    // 実行するアクター
    "script": "await page.goto(inputs.url); ..."  // Playwrightコード
  },
  
  // オプション
  "version": "1.0.0",
  "metadata": { "custom": "fields" }
}

実装の詳細

• script: Playwrightの自動化コードです。ユーザーが提供したパラメータを含むinputsオブジェクトと、ブラウザ自動化用のpageオブジェクトにアクセスできます。
• actorId: 実行するApifyアクターです。デフォルトはcyberfly/apify-agentです。

入力スキーマの例

シンプルなテキスト入力:

{
  "url": {
    "type": "string",
    "description": "Website URL"
  }
}

オプションフィールド:

{
  "timeout": {
    "type": "integer",
    "description": "Timeout in seconds",
    "default": 30
  }
}

列挙型 (ドロップダウン):

{
  "format": {
    "type": "string",
    "enum": ["json", "csv", "markdown"],
    "description": "Output format"
  }
}

使用パターン

単一ツール (開発用)

npx codify-mcp '{"name":"test","description":"Test tool","inputSchema":{"type":"object","properties":{}},"implementation":{"type":"apify-actor","script":"console.log('hello')"}}'

複数ツール (本番用)

npx codify-mcp \
  "$(cat tools/scraper.json)" \
  "$(cat tools/logger.json)" \
  "$(cat tools/analyzer.json)"

環境変数を使用する場合

APIFY_TOKEN="apk_..." npx codify-mcp '{"name":"...","description":"...","inputSchema":{},"implementation":{"type":"apify-actor","script":"..."}}'

npm linkを使用する場合 (ローカルテスト)

cd /path/to/codify-mcp
npm link

# いつでも使用可能
codify-mcp '{"name":"...","description":"...","inputSchema":{},"implementation":{"type":"apify-actor","script":"..."}}'

🔧 技術詳細

認証

トークンの解決順序は以下の通りです。

1. APIFY_TOKEN環境変数 (設定されており、空でない場合)
2. ~/.apify/auth.json (apify login CLIコマンドから)
3. エラー: トークンが見つからない場合、ツールの実行はエラーメッセージとともに失敗します。

トラブルシューティング

"No valid tools in arguments"

引数として有効なJSON文字列を渡していることを確認してください。

# ✓ 正しい
npx codify-mcp '{"name":"test","description":"Test","inputSchema":{"type":"object","properties":{}},"implementation":{"type":"apify-actor","script":"return {ok:true}"}}'

# ✗ 誤り (JSONの周りに引用符がない)
npx codify-mcp {name:"test"...}

# ✗ 誤り (Linux/MacではJSONの周りのシングルクォートはエスケープが必要)
npx codify-mcp '{name:"test"...}'  # 内部でダブルクォートを使用する

"Invalid or missing Apify token"

認証が設定されていることを確認してください。

# オプション1: CLIを介してログイン
apify login

# オプション2: 環境変数を設定
export APIFY_TOKEN="apk_your_token_here"
apify token

"Tool execution failed"

Playwrightスクリプトの構文を確認してください。スクリプトは有効なJavaScriptであり、以下の条件を満たす必要があります。

• inputs (ユーザーが提供したパラメータ)にアクセスできること
• page (Playwrightのページオブジェクト)にアクセスできること
• 値またはオブジェクトを返すこと

// ✓ 有効
await page.goto(inputs.url);
const title = await page.textContent('h1');
return { title };

// ✗ 無効 (awaitが欠けている)
page.goto(inputs.url);

多数のツールセット (50以上のツール)

多数のツールがある場合は、複数のMCPサーバーに分割することを検討してください。

{
  "mcpServers": {
    "apify-scraper": {
      "command": "npx",
      "args": ["codify-mcp", "...tool1...", "...tool2..."]
    },
    "apify-analyzer": {
      "command": "npx",
      "args": ["codify-mcp", "...tool3...", "...tool4..."]
    }
  }
}

開発

ローカルでの実行

npm link
codify-mcp '{"name":"test",...}'

構造

lib/
  index.js              # メインエントリポイント: assembleWrapperCode(), start()
  mcp/
    resolver.js         # モジュールパスのブートストラップ
    auth.js             # トークンの解決
    actor_caller.js     # Apifyアクターの実行
    server_setup.js     # MCPサーバー + ツールの登録

bin/
  start.js    # 実行可能なエントリポイント (package.jsonのbinフィールド)

主要な設計原則

• ファイル不要: ツールは完全に引数を介して渡され、設定ファイルや手動のセットアップは必要ありません。
• base64不要: クリーンで読みやすいコマンドラインで、難読化は行われません。
• 自己完結型: すべての依存関係がバンドルされており、インストール後はオフラインでも動作します。
• ステートレス: 各呼び出しは独立しており、水平スケーリングが容易です。
• 環境変数/CLIからのトークン: シームレスな認証体験で、Apifyエコシステムの規約を尊重します。

📄 ライセンス

Apache-2.0

貢献

github.com/cybairfly/codify-mcpでの問題の報告とプルリクエストを歓迎します。