Trac MCP

🚀 WordPress Trac MCP Server

このModel Context Protocol (MCP)サーバーは、AIアシスタントにWordPress.org Tracのデータへの包括的なアクセスを提供します。TypeScriptで構築され、Cloudflare Workers上にデプロイされています。

🆕 現在、ChatGPT Deep Researchのサポートが追加されました！

🚀 クイックスタート

このMCPサーバーは、WordPress TracをAIがアクセス可能な知識ベースに変換し、WordPressの開発、チケット追跡、コード変更に関するインテリジェントなクエリを可能にします。標準のMCPクライアントとChatGPTのDeep Researchの要件の両方をサポートするデュアルアーキテクチャを備えています。

✨ 主な機能

• デュアルアーキテクチャ：標準MCP + ChatGPT Deep Researchサポート
• キーワード、コンポーネント、またはステータスで60,000以上のWordPressチケットを検索
• 説明、ステータス、メタデータを含む詳細なチケット情報を取得
• 完全な差分コンテンツを含むチェンジセット情報にアクセス
• 最近のWordPress開発活動を監視
• コンポーネント、マイルストーン、優先度などのプロジェクトメタデータを取得
• インテリジェントクエリルーティング：チケット番号、リビジョン、キーワードを自動検出
• スマートキャッシュ：パフォーマンス向上のためにフェッチ操作を最適化
• WordPressブランドの公式スタイルのUI

📦 インストール

Cloudflare Workersへのデプロイ

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

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

# Cloudflareにログイン
wrangler login

# デプロイ
npm run deploy

AIアシスタントへの接続

標準MCP (Claude Desktopなど)

claude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "wordpress-trac": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-worker-url/mcp"]
    }
  }
}

ChatGPT Deep Research

ChatGPTはClaude Desktopとは異なる接続方法を使用します。以下の手順に従ってください。

1. ChatGPT設定を開く → コネクタタブに移動
2. サーバーを追加 → リモートMCPサーバーを直接インポートします。

   https://your-worker-url/mcp/chatgpt
   

3. コンポーザーで有効にする → サーバーがコンポーザー > Deep Researchツールに表示されます。
4. ソースとして追加 → サーバーを調査ソースとして手動で追加する必要がある場合があります。 詳細な設定手順については、ChatGPT MCP Documentationを参照してください。

⚠️ 重要提示

ChatGPTは簡略化されたスキーマで正確に2つのツール (searchとfetch) を必要とします。/mcp/chatgptエンドポイントはこの要件に合わせて特別に最適化されています。

💻 使用例

利用可能なツール

サーバーは、クライアントに応じて2つの異なるツールインターフェイスを提供します。

標準MCPツール

Claude Desktop、MCP Inspector、およびその他の標準MCPクライアント用です。

searchTickets

インテリジェントなフィルタリングでWordPress Tracチケットを検索します。

{
  "tool": "searchTickets",
  "args": {
    "query": "REST API performance",
    "limit": 10,
    "status": "open"
  }
}

getTicket

特定のチケットに関する詳細情報を取得します。

{
  "tool": "getTicket",
  "args": {
    "id": 59166,
    "includeComments": true
  }
}

getChangeset

コードコミットと変更に関する詳細情報にアクセスします。

{
  "tool": "getChangeset",
  "args": {
    "revision": 55567,
    "includeDiff": true,
    "diffLimit": 2000
  }
}

getTimeline

最近のWordPress開発活動を監視します。

{
  "tool": "getTimeline",
  "args": {
    "days": 7,
    "limit": 20
  }
}

getTracInfo

コンポーネントやマイルストーンなどの組織データを取得します。

{
  "tool": "getTracInfo",
  "args": {
    "type": "components"
  }
}

ChatGPT Deep Researchツール

ChatGPTのDeep Research機能 (簡略化されたインターフェイス) 用です。

search

クエリに基づいて適切なデータに自動的にルーティングするインテリジェントな検索です。

{
  "tool": "search",
  "args": {
    "query": "block editor performance"
  }
}

サポートされるクエリタイプ:

• キーワード: "REST API bugs", "media upload issues"
• チケット番号: "#61234", "61234"
• チェンジセット: "r58504", "58504"
• 最近の活動: "recent", "timeline", "latest"
• コンポーネント: "Block Editor", "REST API"

fetch

IDで特定のアイテムに関する詳細情報を取得します。

{
  "tool": "fetch",
  "args": {
    "id": "61234"
  }
}

サポートされるID形式:

• チケットID: "61234"
• チェンジセットリビジョン: "r58504"

🔧 技術詳細

• ランタイム：グローバルエッジデプロイメント用のCloudflare Workers
• 言語：Zod検証を備えたTypeScript
• プロトコル：汎用AI互換性のためのModel Context Protocol (MCP)
• API：公開WordPress Trac CSV/RSSエンドポイント (認証不要)

📚 ドキュメント

開発

ローカル開発

# 開発サーバーを起動
npm run dev

# MCP Inspectorでテスト
npx @modelcontextprotocol/inspector http://localhost:8787/mcp

テスト

# 型チェックを実行
npm run type-check

# リントを実行
npm run lint

# デプロイをテスト
curl https://your-worker-url/health

ライブデモ

URL: https://mcp-server-wporg-trac-staging.a8cai.workers.dev

📄 ライセンス

このプロジェクトはGNU General Public License v2以降のライセンスの下で提供されています。詳細については、GPL Licenseを参照してください。

コントリビューション

コントリビューションは大歓迎です！このサーバーは、実世界の複雑さとWordPress統合を持つ本番環境対応のMCPサーバーを構築する方法を示しています。