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 服务器。