Trac MCP

🚀 WordPress Trac MCP 服務器

這是一個模型上下文協議（MCP）服務器，能讓 AI 助手全面訪問 WordPress.org Trac 數據。它採用 TypeScript 構建，並部署在 Cloudflare Workers 上。

🆕 現已支持 ChatGPT 深度研究功能！

🚀 快速開始

本 MCP 服務器將 WordPress Trac 轉化為一個可供 AI 訪問的知識庫，支持對 WordPress 開發、工單跟蹤和代碼變更進行智能查詢。它採用雙架構設計，既支持標準 MCP 客戶端，也滿足 ChatGPT 深度研究的需求。

✨ 主要特性

• 雙架構支持：兼容標準 MCP 協議，並支持 ChatGPT 深度研究功能。
• 可通過關鍵詞、組件或狀態搜索超過 60,000 張 WordPress 工單。
• 獲取詳細的工單信息，包括描述、狀態和元數據。
• 訪問變更集信息，包含完整的差異內容。
• 監控 WordPress 近期的開發活動。
• 檢索項目元數據，如組件、里程碑和優先級。
• 智能查詢路由：自動識別工單編號、版本號和關鍵詞。
• 智能緩存機制：優化數據獲取操作，提升性能。
• 採用 WordPress 官方風格的用戶界面。

💻 使用示例

可用工具

服務器根據不同的客戶端提供兩種不同的工具接口：

標準 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 深度研究工具

適用於 ChatGPT 的深度研究功能（簡化接口）：

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

# 克隆倉庫
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 深度研究

ChatGPT 與 Claude Desktop 的連接方式不同，請按以下步驟操作：

1. 打開 ChatGPT 設置 → 轉到 連接器 選項卡。
2. 添加服務器 → 直接導入遠程 MCP 服務器地址：

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

3. 在編輯器中啟用 → 服務器將顯示在 編輯器 > 深度研究 工具中。
4. 添加為數據源 → 可能需要手動將服務器添加為研究數據源。

詳細設置說明請參考：ChatGPT MCP 文檔

⚠️ 重要提示

ChatGPT 僅需要 2 個工具（search 和 fetch），且要求使用簡化的模式。/mcp/chatgpt 端點專門針對此需求進行了優化。

📚 詳細文檔

開發

本地開發

# 啟動開發服務器
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

🔧 技術細節

• 運行環境：Cloudflare Workers，支持全球邊緣部署。
• 開發語言：TypeScript，使用 Zod 進行數據驗證。
• 協議標準：採用模型上下文協議（MCP），確保與各種 AI 系統兼容。
• API 接口：使用公共的 WordPress Trac CSV/RSS 端點，無需身份驗證。

實時演示

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

📄 許可證

本項目採用 GNU 通用公共許可證 v2 或更高版本許可 - 詳情請參閱 GPL 許可證。

貢獻說明

歡迎貢獻代碼！本服務器展示瞭如何構建具有實際複雜度並集成 WordPress 的生產級 MCP 服務器。