项目简介

Harness MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端,旨在为大型语言模型 (LLM) 客户端提供访问 Harness 平台的上下文信息和功能。通过实现 MCP 协议,它将 Harness 的各项能力(如管理流水线、列出连接器等)转化为 LLM 可理解和调用的工具。

主要功能点

  • Harness API 集成: 作为 Harness API 的代理层,安全地访问 Harness 平台数据。
  • 工具调用: 提供结构化的工具,允许 LLM 执行如获取、列出 Harness 流水线等操作。
  • 上下文提供: 向 LLM 提供关于 Harness 资源的最新信息,增强对话和自动化能力。

安装步骤

  1. 安装 Go 语言: 确保你的系统已安装 Go 1.23 或更高版本。
  2. 克隆仓库: 打开终端,运行以下命令克隆项目代码:
    git clone https://github.com/vistaarjuneja/harness-mcp.git
    cd harness-mcp
  3. 构建服务器程序: 在项目根目录下运行:
    go build -o harness-mcp-server ./cmd/harness-mcp-server
    这将在当前目录下生成一个名为 'harness-mcp-server' 的可执行文件。

服务器配置(供 MCP 客户端使用)

MCP 服务器通常由支持 MCP 协议的客户端(如特定的 LLM 应用或桌面客户端)启动和管理。以下是配置客户端连接到此服务器的示例信息,你需要根据你使用的具体客户端修改其配置文件:

{
  "mcpServers": {
    "harness": {
      // 启动 Harness MCP 服务器的可执行文件路径
      "command": "/path/to/harness-mcp-server",
      // 传递给服务器的参数,"stdio" 指示使用标准输入输出进行通信
      "args": ["stdio"],
      // 启动服务器时设置的环境变量,此处用于提供 Harness API Key
      "env": {
        "HARNESS_API_KEY": "<YOUR_API_KEY>" 
      }
    }
  }
}

请将 '/path/to/harness-mcp-server' 替换为你实际构建出的服务器程序路径,并将 '<YOUR_API_KEY>' 替换为你的 Harness API Key。

基本使用方法

在配置好 MCP 客户端后,启动你的客户端应用。客户端会自动根据配置信息启动 Harness MCP 服务器并与之建立连接。服务器会在后台运行,并通过 MCP 协议响应客户端(即 LLM)发起的工具调用等请求。

你也可以直接在终端运行服务器(通常用于测试或调试):

HARNESS_API_KEY=your_api_key /path/to/harness-mcp-server stdio

请将 'your_api_key' 替换为你的 Harness API Key,'/path/to/harness-mcp-server' 替换为服务器程序路径。服务器启动后会等待通过标准输入接收 MCP 请求。

信息

分类

开发者工具