内容
# 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 官方样式的 UI
## 可用工具
服务器根据客户端的不同提供两种工具接口：
### 标准 MCP 工具
适用于 Claude Desktop、MCP Inspector 等标准 MCP 客户端：
#### searchTickets
通过智能过滤搜索 WordPress Trac 工单。
```json
{
"tool": "searchTickets",
"args": {
"query": "REST API 性能",
"limit": 10,
"status": "open"
}
}
```
#### getTicket
检索特定工单的综合信息。
```json
{
"tool": "getTicket",
"args": {
"id": 59166,
"includeComments": true
}
}
```
#### getChangeset
访问代码提交和更改的详细信息。
```json
{
"tool": "getChangeset",
"args": {
"revision": 55567,
"includeDiff": true,
"diffLimit": 2000
}
}
```
#### getTimeline
监控最近的 WordPress 开发活动。
```json
{
"tool": "getTimeline",
"args": {
"days": 7,
"limit": 20
}
}
```
#### getTracInfo
获取组织数据，如组件和里程碑。
```json
{
"tool": "getTracInfo",
"args": {
"type": "components"
}
}
```
### ChatGPT 深度研究工具
适用于 ChatGPT 的深度研究功能（简化接口）：
#### search
智能搜索，根据查询自动路由到正确的数据。
```json
{
"tool": "search",
"args": {
"query": "区块编辑器性能"
}
}
```
**支持的查询类型：**
- **关键词**：`"REST API 错误"`、`"媒体上传问题"`
- **工单编号**：`"#61234"`、`"61234"`
- **变更集**：`"r58504"`、`"58504"`
- **最近活动**：`"recent"`、`"timeline"`、`"latest"`
- **组件**：`"区块编辑器"`、`"REST API"`
#### fetch
获取特定项目的详细信息，ID。
```json
{
"tool": "fetch",
"args": {
"id": "61234"
}
}
```
**支持的 ID 格式：**
- 工单 ID：`"61234"`
- 变更集修订版：`"r58504"`
## 安装
### 部署到 Cloudflare Workers
```bash
# 克隆仓库
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`：
```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. **在 Composer 中启用** → 服务器将在 **Composer** > **深度研究** 工具中显示
4. **添加为源** → 您可能需要手动将服务器添加为研究源
有关详细设置说明，请参阅：[ChatGPT MCP 文档](https://platform.openai.com/docs/mcp#connect-in-chatgpt)
> **注意**：ChatGPT 需要确切的 2 个工具（`search` 和 `fetch`），采用简化的模式。`/mcp/chatgpt` 端点专门针对此要求进行了优化。
## 开发
### 本地开发
```bash
# 启动开发服务器
npm run dev
# 使用 MCP Inspector 测试
npx @modelcontextprotocol/inspector http://localhost:8787/mcp
```
### 测试
```bash
# 运行类型检查
npm run type-check
# 运行 linting
npm run lint
# 测试部署
curl https://your-worker-url/health
```
## 架构
- **运行时**：Cloudflare Workers，用于全球边缘部署
- **语言**：TypeScript，带有 Zod 验证
- **协议**：模型上下文协议（MCP），用于通用 AI 兼容性
- **API**：公共 WordPress Trac CSV/RSS 端点（无需身份验证）
## 现场演示
**网址**：https://mcp-server-wporg-trac-staging.a8cai.workers.dev
## 许可证
该项目根据 GNU 通用公共许可证 v2 或更高版本许可 - 有关详细信息，请参阅 [GPL 许可证](https://www.gnu.org/licenses/gpl-3.0.en.html#license-text)。
## 贡献
欢迎贡献！此服务器演示了如何使用现实世界的复杂性和 WordPress 集成构建生产就绪的 MCP 服务器。
