# WordPress Trac MCP Server
Search and explore all WordPress.org Trac issue trackers directly from Claude, ChatGPT, or any AI assistant that supports MCP (Model Context Protocol).
**No coding required to use this** - just add the server URLs to your AI assistant config.
Based on [trac-mcp](https://github.com/Jameswlepage/trac-mcp) by James LePage.
---
## Quick Start (No Coding Required)
### For Claude Desktop Users
1. Open your Claude Desktop config file:
- **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
2. Add the WordPress Trac servers to the `mcpServers` section:
```json
{
"mcpServers": {
"wordpress-core-trac": {
"command": "npx",
"args": ["mcp-remote", "https://mcp-server-wporg-core-trac.meta-trac-wordpress.workers.dev/mcp"]
},
"wordpress-meta-trac": {
"command": "npx",
"args": ["mcp-remote", "https://mcp-server-wporg-meta-trac.meta-trac-wordpress.workers.dev/mcp"]
},
"wordpress-plugins-trac": {
"command": "npx",
"args": ["mcp-remote", "https://mcp-server-wporg-plugins-trac.meta-trac-wordpress.workers.dev/mcp"]
},
"wordpress-themes-trac": {
"command": "npx",
"args": ["mcp-remote", "https://mcp-server-wporg-themes-trac.meta-trac-wordpress.workers.dev/mcp"]
},
"wordpress-bbpress-trac": {
"command": "npx",
"args": ["mcp-remote", "https://mcp-server-wporg-bbpress-trac.meta-trac-wordpress.workers.dev/mcp"]
},
"wordpress-buddypress-trac": {
"command": "npx",
"args": ["mcp-remote", "https://mcp-server-wporg-buddypress-trac.meta-trac-wordpress.workers.dev/mcp"]
},
"wordpress-glotpress-trac": {
"command": "npx",
"args": ["mcp-remote", "https://mcp-server-wporg-glotpress-trac.meta-trac-wordpress.workers.dev/mcp"]
}
}
}
```
3. **Restart Claude Desktop**
4. You can now ask Claude things like:
- "Search Core Trac for accessibility issues"
- "Find recent plugin directory tickets"
- "Show me ticket #12345 from Meta Trac"
- "What's the latest activity on BuddyPress Trac?"
### For ChatGPT Users
1. Open ChatGPT Settings → Connectors tab
2. Add Server → Import remote MCP server
3. Use any of these URLs:
- Core: `https://mcp-server-wporg-core-trac.meta-trac-wordpress.workers.dev/mcp/chatgpt`
- Meta: `https://mcp-server-wporg-meta-trac.meta-trac-wordpress.workers.dev/mcp/chatgpt`
- Plugins: `https://mcp-server-wporg-plugins-trac.meta-trac-wordpress.workers.dev/mcp/chatgpt`
- Themes: `https://mcp-server-wporg-themes-trac.meta-trac-wordpress.workers.dev/mcp/chatgpt`
- bbPress: `https://mcp-server-wporg-bbpress-trac.meta-trac-wordpress.workers.dev/mcp/chatgpt`
- BuddyPress: `https://mcp-server-wporg-buddypress-trac.meta-trac-wordpress.workers.dev/mcp/chatgpt`
- GlotPress: `https://mcp-server-wporg-glotpress-trac.meta-trac-wordpress.workers.dev/mcp/chatgpt`
4. Enable in Composer → Deep Research tool
---
## What You Can Search
| Trac Instance | What It Tracks | Live URL |
|---------------|----------------|----------|
| **Core** | WordPress core bugs, features, enhancements | [core.trac.wordpress.org](https://core.trac.wordpress.org) |
| **Meta** | WordPress.org website and infrastructure | [meta.trac.wordpress.org](https://meta.trac.wordpress.org) |
| **Plugins** | Plugin directory issues and reviews | [plugins.trac.wordpress.org](https://plugins.trac.wordpress.org) |
| **Themes** | Theme reviews and directory | [themes.trac.wordpress.org](https://themes.trac.wordpress.org) |
| **bbPress** | bbPress forum software | [bbpress.trac.wordpress.org](https://bbpress.trac.wordpress.org) |
| **BuddyPress** | BuddyPress social networking plugin | [buddypress.trac.wordpress.org](https://buddypress.trac.wordpress.org) |
| **GlotPress** | Translation platform | [glotpress.trac.wordpress.org](https://glotpress.trac.wordpress.org) |
## Available Commands
Once connected, you can ask your AI assistant to:
- **Search tickets**: "Search for REST API issues" or "Find tickets about block editor"
- **Get ticket details**: "Show me ticket #58000" or "What's the status of ticket 12345?"
- **View changesets**: "Show changeset r58000" or "What changed in revision 55000?"
- **Check timeline**: "What happened on Core Trac this week?"
- **Get project info**: "List the milestones for WordPress 6.7"
---
## For Developers
### Deploy Your Own Instance
```bash
# Clone the repository
git clone https://github.com/courtneyr-dev/meta-trac.git
cd meta-trac
# Install dependencies
npm install
# Login to Cloudflare
npx wrangler login
# Deploy specific instances
npm run deploy:core # Core Trac
npm run deploy:meta # Meta Trac
npm run deploy:plugins # Plugins Trac
npm run deploy:themes # Themes Trac
npm run deploy:bbpress # bbPress Trac
npm run deploy:buddypress # BuddyPress Trac
npm run deploy:glotpress # GlotPress Trac
# Or deploy ALL at once
npm run deploy:all
```
### Environment Variables
| Variable | Values | Default | Description |
|----------|--------|---------|-------------|
| `TRAC_INSTANCE` | `core`, `meta`, `plugins`, `themes`, `bbpress`, `buddypress`, `glotpress` | `meta` | Which Trac instance |
| `TRAC_BASE_URL` | URL | (auto) | Override the base URL |
### Local Development
```bash
# Start dev server
npm run dev
# Test with MCP Inspector
npx @modelcontextprotocol/inspector http://localhost:8787/mcp
# Run tests
npm run test:unit
# Type check
npm run type-check
```
### API Testing
```bash
# Health check
curl https://mcp-server-wporg-core-trac.meta-trac-wordpress.workers.dev/health
# Search tickets
curl -X POST 'https://mcp-server-wporg-core-trac.meta-trac-wordpress.workers.dev/mcp' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"searchTickets","arguments":{"query":"accessibility","limit":5}},"id":1}'
```
## Architecture
- **Runtime**: Cloudflare Workers (global edge deployment)
- **Language**: TypeScript with Zod validation
- **Protocol**: Model Context Protocol (MCP)
- **APIs**: Public WordPress Trac CSV/RSS endpoints (no auth required)
## Known Limitations
- Comment history not available via CSV API (visit ticket URL for full discussion)
- Components list requires sampling tickets to extract values
- Each Trac instance is a separate deployment
## License
GNU General Public License v2 or later - see [GPL License](https://www.gnu.org/licenses/gpl-3.0.en.html).
## Contributing
Contributions welcome! This server demonstrates production-ready MCP servers with multi-instance support.
