coroot-mcp

文档 · Coroot · 变更日志 · 贡献指南 · MCP清单

Coroot MCP 是一个模型上下文协议（MCP）服务器，它将您的 Coroot 可观察性堆栈转换成一组LLM助手可以调用以进行根本原因分析的工具。

这是一个由社区维护的集成，并非官方的Coroot产品或认可。

它作为一个 Spring Boot 3 / Spring AI 1.1.x 应用程序实现，并通过HTTP在 /mcp 提供一个JSON-RPC 2.0 MCP端点。

该项目采用MIT许可证。

快速开始（无需Coroot）

您可以在不使用Coroot实例的情况下尝试MCP服务器，只需启用内置的存根客户端配置文件。这会返回合成事件和健康快照，足以用于测试工具连接。

./mvnw spring-boot:run -Dspring-boot.run.profiles=stub-coroot

MCP JSON-RPC端点将在以下位置可用：

• POST http://localhost:8080/mcp

快速开始（真实Coroot）

要指向一个真实的Coroot实例：

1. 在此仓库中创建一个本地的.env.local文件（已加入.gitignore），内容如下：

   COROOT_API_URL=https://coroot.your-company.com
   COROOT_API_KEY=<您的Coroot API密钥>
   COROOT_DEFAULT_PROJECT_ID=production
   
   OPENAI_API_KEY=<您的OpenAI/OpenAI兼容密钥>
   OPENAI_MODEL=gpt-4.1-mini
   

2. 启动服务器：

   set -a
   source .env.local
   set +a
   
   ./mvnw spring-boot:run
   

3. 验证其是否运行：

   curl -s http://localhost:8080/actuator/health
   curl -s http://localhost:8080/mcp \
     -H 'Content-Type: application/json' \
     -d '{"jsonrpc":"2.0","id":"init-1","method":"initialize","params":{}}'
   

4. 将您的MCP感知客户端（如Codex、Claude、Toolhive等）指向http://localhost:8080/mcp并开始使用诸如list_recent_incidents和investigate_incident之类的工具。

使用AI编码代理

此项目通过HTTP支持MCP。一旦您将客户端指向/mcp端点，任何MCP感知的编码助手都可以与其通信。

Codex CLI（本地MCP）

假设coroot-mcp运行在http://localhost:8080/mcp，在您的Codex配置中添加一个MCP服务器条目，例如：

[mcp_servers.coroot-mcp]
command = "npx"
args = ["-y", "mcp-remote", "http://localhost:8080/mcp", "--allow-http", "--transport", "http-first"]

重启Codex CLI并列出MCP服务器以确认coroot-mcp可用。

Claude / Claude Code（HTTP MCP）

如果您使用的是支持HTTP MCP服务器的基于Claude的环境，请配置一个新的名为coroot-mcp的MCP服务器：

• 类型：HTTP
• URL：http://localhost:8080/mcp

然后您可以从该环境中调用list_recent_incidents和summarize_incident_root_cause。

配置示例（JSON）

一些工具和IDE偏好基于JSON的MCP配置文件。下面的片段反映了截至2025年末许多MCP感知代理所期望的内容；根据您的环境调整路径和密钥。

通用.mcp.json（项目级）

您可以在仓库根目录下保留一个项目范围的MCP配置.mcp.json：

{
  "mcpServers": {
    "coroot-mcp": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

某些客户端也支持这里的env块；如果您的客户端支持，您可以记录预期的变量：

{
  "mcpServers": {
    "coroot-mcp": {
      "type": "http",
      "url": "http://localhost:8080/m[END_OF_TEXT]