trac mcp服务器
独立的MCP服务器，使AI代理能够通过模型上下文协议完全访问Trac项目管理——票、维基、里程碑和搜索。
快速开始
pip install .设置Trac连接：
export TRAC_URL="https://trac.example.com"
export TRAC_USERNAME="your-username"
export TRAC_PASSWORD="your-password"运行服务器：
trac-mcp-server配置
通过环境变量进行配置， .env 文件或YAML配置文件(.trac_mcp/config.yaml):
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
TRAC_URL | 是 | -- | Trac实例URL |
TRAC_USERNAME | 是 | -- | Trac用户名 |
TRAC_PASSWORD | 是 | -- | Trac密码 |
TRAC_INSECURE | 没有 | false | 跳过SSL验证（仅限开发） |
TRAC_DEBUG | 没有 | false | 启用调试日志记录 |
TRAC_MAX_PARALLEL_REQUESTS | 没有 | 5 | 最大并行XML-RPC请求数 |
TRAC_MAX_BATCH_SIZE | 没有 | 500 | 每批操作的最大项目数（1-10000） |
有关YAML配置文件格式和高级选项，请参阅 配置参考.
MCP客户端集成
克劳德桌面
增添 claude_desktop_config.json:
{
"mcpServers": {
"trac": {
"command": "trac-mcp-server",
"env": {
"TRAC_URL": "https://trac.example.com",
"TRAC_USERNAME": "your-username",
"TRAC_PASSWORD": "your-password"
}
}
}
}克劳德代码
claude mcp add trac -e TRAC_URL=https://trac.example.com \
-e TRAC_USERNAME=your-username \
-e TRAC_PASSWORD=your-password \
-- trac-mcp-server其他MCP客户端
任何支持stdio传输的MCP客户端都可以启动 trac-mcp-server 作为一个子流程。通过环境变量传递Trac凭据。
可用工具（27）
门票（11）
| 工具 | 说明 |
|---|---|
ticket_search | 使用Trac查询语言搜索门票 |
ticket_get | 通过ID获取门票详细信息 |
ticket_create | 创建新票 |
ticket_update | 更新现有票证 |
ticket_delete | 删除门票 |
ticket_changelog | 获取机票更改历史记录 |
ticket_fields | 列出可用的票字段 |
ticket_actions | 获取可用票操作 |
ticket_batch_create | 一批创建多张票 |
ticket_batch_delete | 一批删除多张票 |
ticket_batch_update | 一次性更新多张票 |
维基（6）
| 工具 | 说明 |
|---|---|
wiki_get | 获取wiki页面内容（使用Markdown转换） |
wiki_search | 搜索wiki页面 |
wiki_create | 创建新的wiki页面 |
wiki_update | 更新现有wiki页面 |
wiki_delete | 删除wiki页面 |
wiki_recent_changes | 列出最近的wiki更改 |
Wiki文件（3）
| 工具 | 说明 |
|---|---|
wiki_file_push | 将本地文件推送到wiki（自动格式转换） |
wiki_file_pull | 将wiki页面拉到本地文件 |
wiki_file_detect_format | 检测内容格式（Markdown/TracWiki） |
里程碑（5）
| 工具 | 说明 |
|---|---|
milestone_list | 列出所有里程碑 |
milestone_get | 获取里程碑详细信息 |
milestone_create | 创建新的里程碑 |
milestone_update | 更新现有里程碑 |
milestone_delete | 删除里程碑 |
系统（2）
| 工具 | 说明 |
|---|---|
ping | 测试连接并返回API版本 |
get_server_time | 获取Trac服务器时间 |
发展
pip install -e ".[dev]"
pytest tests/ -v项目结构
src/trac_mcp_server/
config.py # Environment variable configuration
core/ # Trac XML-RPC client, async utilities
mcp/ # MCP server, tools, resources
converters/ # Markdown TracWiki conversion
detection/ # Content format detection文档
看 docs/reference/overview.md 有关详细的工具参考、配置和故障排除。