项目简介

'zopen-mcp-server' 是一个基于Go语言开发的模型上下文协议（MCP）服务器。它的核心功能是将 'zopen' 和 'zopen-generate' 这两个命令行工具的功能封装成一系列可供AI助手调用的工具。通过此服务器，AI助手可以管理z/OS上的软件包，将开源软件移植到z/OS，并生成zopen兼容的项目结构。服务器支持在本地机器或通过SSH连接到远程z/OS系统执行命令。

主要功能点

远程与本地执行: 可以在本地或通过SSH在远程z/OS系统上运行 'zopen' 和 'zopen-generate' 命令。
AI工具集成: 将 'zopen' 和 'zopen-generate' 的各项功能注册为AI代理可调用的工具，如软件包安装、查询、构建项目、生成项目结构等。
项目生成: 创建高度可定制的zopen兼容项目，包括指定许可证、分类和构建系统。
元数据查询: 查询有效的许可证、项目类别和构建系统信息。
构建支持: 在指定目录中构建zopen项目，并提供详细的输出。
上下文提供: 将'AGENTS.md'文件作为资源提供给AI代理，指导其进行z/OS软件移植工作流。

安装步骤

安装Go语言环境: 确保您的系统已安装Go 1.23或更高版本。
安装zopen和zopen-generate: 在本地或目标z/OS系统上安装 'zopen' 和 'zopen-generate' 工具，并确保它们在系统PATH中可访问。

安装zopen-mcp-server:

推荐方式（Go安装）: 在命令行中运行 'go install github.com/zopencommunity/zopen-mcp-server@latest'。这将把 'zopen-mcp-server' 可执行文件安装到 '$GOPATH/bin' 目录。

从源代码构建:

git clone https://github.com/zopencommunity/zopen-mcp-server.git
cd zopen-mcp-server
make build # 或者直接使用 go build -o zopen-mcp-server zopen-server.go

服务器配置

MCP服务器通常由一个MCP客户端应用程序（如AI代理桌面应用）启动和管理。以下是您可能需要在MCP客户端配置中添加的JSON示例，用于指示客户端如何启动和连接到 'zopen-mcp-server'。

本地模式 (默认):

{
  "mcpServers": {
    "zopen": {
      "command": "zopen-mcp-server",
      "args": []
    }
  }
}

说明：'command' 指定了服务器可执行文件的名称，'args' 为空表示使用默认本地模式。如果 'zopen-mcp-server' 不在系统PATH中，请使用其完整路径，例如 '/Users/yourname/go/bin/zopen-mcp-server'。

远程模式 (通过SSH连接z/OS):

{
  "mcpServers": {
    "zopen": {
      "command": "zopen-mcp-server",
      "args": [
        "--remote",
        "--host", "您的z/OS主机名或IP",
        "--user", "您的SSH用户名",
        "--key", "/path/to/您的SSH私钥文件"
      ]
    }
  }
}

说明：
- '--remote': 启用远程模式。
- '--host': 您的z/OS系统的主机名或IP地址。
- '--user': 用于SSH连接的用户名。
- '--key': SSH私钥文件的路径，用于无密码认证。
- 您可以通过 'args' 额外添加 '--port <端口号>' 参数来指定SSH端口（默认为22）。

包含上下文信息: 您还可以配置AI代理以加载'AGENTS.md'作为上下文，这有助于AI理解z/OS软件移植的最佳实践和工作流程。

{
  "mcpServers": {
    "zopen": {
      "command": "zopen-mcp-server",
      "args": []
    }
  },
  "context": {
    "fileName": ["AGENTS.md"]
  }
}

配置更新后，请重启您的AI代理应用程序，以便更改生效。

基本使用方法

配置完成后，您的AI代理即可访问并使用 'zopen' 和 'zopen-generate' 提供的所有工具。您可以直接向AI代理提出自然语言请求，例如：

"将 'curl' 移植到z/OS。" (AI将尝试生成项目、识别构建系统并进行构建)
"为 'openssl' 生成一个使用MIT许可证的zopen项目。"
"在 '/path/to/curlport' 目录中构建项目。"
"zopen中有哪些可用的软件包？"
"显示 'bash' 软件包的详细信息。"
"在我的z/OS系统上安装 'git' 和 'make'。"
"支持哪些构建系统？"

详细的AI代理使用指南和工作流请参考服务器提供的 'zopen://guides/porting-workflow' 资源。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息