opsorch mcp
](https://github.com/OpsOrch/opsorch-mcp/releases)  
opsorch-mcp是OpsArch的模型上下文协议（mcp）服务器。它将OpsArch Core HTTP API公开为LLM和代理运行时的安全、只读MCP工具。
入门
本地开发
npm install
npm run dev # runs via ts-node over stdio
# or
npm run build && npm start服务器默认使用stdio传输；从指向编译的MCP客户端（例如，Claude Code、MCP Inspector、Cursor）生成它 dist/index.js.
码头工人
每次发布时，Docker镜像都会自动构建并发布到GitHub容器注册表。您可以使用Docker运行MCP服务器：
# Pull the latest version
docker pull ghcr.io/opsorch/opsorch-mcp:latest
# Run with environment variables
docker run -d \
--name opsorch-mcp \
-p 7070:7070 \
-e OPSORCH_CORE_URL=http://localhost:8080 \
-e OPSORCH_CORE_TOKEN=changeme \
-e MCP_HTTP_PORT=7070 \
ghcr.io/opsorch/opsorch-mcp:latest
# Or run a specific version
docker pull ghcr.io/opsorch/opsorch-mcp:v1.0.0
# Using Docker Compose
cat > docker-compose.yml 0`).保持请求的行精简（数十行，而不是数百行），除非有人明确批准更广泛的获取。
- **范围**: `scope.service`, `scope.team`，以及 `scope.environment` 是可选字符串，用于缩小每个查询的范围，并且在已知时应始终设置。
- **事故查询(`query-incidents`)**: `query` 是一个自由文本字符串； `statuses`/`severities` 是字符串数组； `metadata` 是一个具有提供程序特定密钥的对象。
- **警报查询(`query-alerts`)**: `query` 是一个自由文本字符串； `statuses`/`severities` 是字符串数组。
- **日志查询(`query-logs`)**: `start`/`end` 是ISO-8601时间戳； `limit` 是最大条目数； `providers` 是一个可选的字符串数组，因此您可以强制使用连接器。在要求批准昂贵的扫描之前，始终限制时间范围。
- **度量查询(`query-metrics`)**: `expression` 是提供者本机查询字符串； `step` 是提供商接受的持续时间字符串（例如。， `30s`, `5m`).时间戳遵循ISO-8601。
- **描述指标(`describe-metrics`)**: `scope` 是标准查询范围。
- **服务查询(`query-services`)**: `ids` 是一个可选的字符串数组； `tags` 是字符串键/值过滤器的映射。
- **团队查询(`query-teams`)**: `name` 是用于基于名称的过滤的可选字符串； `tags` 是团队属性的字符串键/值过滤器的映射。
- **票务查询(`query-tickets`)**: `query` 是一个自由文本字符串； `statuses`/`assignees` 是字符串数组。
- **部署查询(`query-deployments`)**: `query` 是一个自由文本字符串； `statuses`/`environments` 是字符串数组；支持针对目标部署搜索的标准范围过滤。
## 资源
- `opsorch://docs/agents-architecture` –服务 `AGENTS.md` 因此客户端可以直接检索OpsArch代理架构内容。
## 项目脚本
- `npm run dev` –使用ts节点运行TypeScript入口点。
- `npm run build` –将编译好的JS发送到 `dist/`.
- `npm start` –从以下位置运行编译后的服务器 `dist/`.
填写 `AGENTS.md` 根据需要；所有工具都已针对Opsarch核心HTTP API表面。
## 发布
该项目通过GitHub Actions使用自动发布。发布是手动触发的，包括：
- **语义版本控制** 具有可配置的版本凸起（主要、次要、补丁）
- **自动化测试** 释放前要脱衣服
- **Git标记** 具有正确的版本格式(`v{major}.{minor}.{patch}`)
- **变更日志生成** 从提交历史
- **Docker镜像发布** 转到GitHub容器注册表
- **GitHub发布** 附发行说明
### 创建发布
维护人员可以通过以下方式创建新版本：
1. 去 [操作选项卡](https://github.com/OpsOrch/opsorch-mcp/actions)
1. 选择“发布”工作流
1. 点击“运行工作流”
1. 选择版本凹凸类型：
- **补丁** -Bug修复和小更新（1.0.0→1.0.1）
- **次要的** -新功能，向后兼容（1.0.0→1.1.0）
- **主要的** -重大更改（1.0.0→2.0.0）
1. 点击“运行工作流”
发布过程将自动：
- 运行所有测试和linting
- 计算下一个版本号
- 创建并推送一个git标签
- 为多种架构（linux/amd64、linux/arm64）构建和发布Docker镜像
- 使用changelog创建GitHub版本
### 安装选项
**Docker：**
docker pull ghcr.io/opsorch/opsorch-mcp:latest
**GitHub发布：**
从下载发布工件 [发布页面](https://github.com/OpsOrch/opsorch-mcp/releases).