tp-mcp开始
用于Apptio目标进程API的基于Go-的MCP(模型上下文协议)服务器。此服务器取代了TypeScript版本,并使用 狐狸语境 框架。
构建说明
go build ./cmd/server/这将生成一个 server 可在当前目录中执行。
配置
服务器需要两个环境变量:
TP_DOMAIN-您的目标流程域(例如。,your-domain.tpondemand.com)TP_ACCESS_TOKEN-您的目标进程API访问令牌
您可以在shell环境中设置这些参数,也可以在运行服务器时提供这些参数。
使用Claude Desktop/Cline/Goose
将以下配置添加到MCP客户端设置中:
{
"mcpServers": {
"targetprocess": {
"command": "/path/to/server",
"env": {
"TP_DOMAIN": "your-domain.tpondemand.com",
"TP_ACCESS_TOKEN": "your-token"
}
}
}
}替换 /path/to/server 其中包含指向已构建服务器可执行文件的绝对路径。
使用Claude代码(Docker)
claude mcp add targetprocess -- docker run -i --rm -e TP_DOMAIN=your-domain.tpondemand.com -e TP_ACCESS_TOKEN=your-token ghcr.io/kildall/tp-mcp-go:latest替换 your-domain.tpondemand.com 和 your-token 与你的实际价值观。
可用工具
服务器提供以下10个与目标进程交互的工具:
- 搜索 -使用过滤器(状态、分配的用户、项目、团队等)和分页支持搜索实体
- get_entity -按类型和ID检索单个实体,并包含可选字段
- create_entity -使用名称、描述、项目、团队和自定义字段创建新实体
- update_entity -更新实体字段,包括名称、描述、状态和分配
- 添加注释 -向实体添加私人评论
- list_注释 -列出对实体的所有评论
- 列表_附件 -列出实体上的所有附件
- 下载_附件 -按ID下载附件内容
MCP资源
服务器提供以下文档资源:
docs://getting-started-简介和快速入门指南docs://tool-reference-所有工具的详细参考docs://examples-使用示例和常见工作流程docs://query-guide-过滤和查询实体指南docs://authentication-身份验证设置和故障排除
发展
运行测试
go test ./...项目结构
tp-mcp-go/
├── cmd/server/ # Main server entry point
├── internal/
│ ├── app/ # Application lifecycle and DI module
│ ├── client/ # Target Process API client
│ │ └── auth/ # Authentication handling
│ ├── config/ # Configuration management
│ ├── domain/ # Domain models and business logic
│ │ ├── entity/ # Entity types and models
│ │ ├── query/ # Query building and filtering
│ │ └── errors/ # Domain-specific errors
│ ├── tools/ # MCP tool implementations
│ └── testutil/ # Testing utilities and fixtures
├── go.mod # Go module definition
└── README.md # This file许可证
这是一个个人项目,与Apptio、Target Process或任何其他第三方无关。
