🚀 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 的连接方式不同，请按以下步骤操作：
- 打开 ChatGPT 设置 → 转到 连接器 选项卡。
- 添加服务器 → 直接导入远程 MCP 服务器地址：
https://your-worker-url/mcp/chatgpt - 在编辑器中启用 → 服务器将显示在 编辑器 > 深度研究 工具中。
- 添加为数据源 → 可能需要手动将服务器添加为研究数据源。
详细设置说明请参考：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 服务器。