目标流程API协议服务器

一个基于Go语言构建的MCP服务器,用于与Target Process API交互,提供实体管理、查询和文件操作等功能。

  • by Kildall
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 Kildall/tp-mcp-go

使用说明

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或任何其他第三方无关。