远程开发服务器日志检索工具

用于从Kubernetes中的OpenShift Dev Spaces远程开发服务器Pod检索日志的MCP服务器,支持自动检测IDE目录、模式匹配查找Pod以及从IDE日志中检索Java异常和错误。

  • by adietish
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 adietish/mcp-devspaces-logs

使用说明

MCP开发空间日志

模型上下文协议(MCP)服务器,用于从Kubernetes中运行的OpenShift Dev Spaces远程开发服务器Pod中检索日志。

特性

  • 🔍 自动检测pod中的IDE目录
  • 📦 通过模式匹配查找Pod
  • 📝 从IDE日志中检索Java异常和错误
  • ⚡ 与Claude Code无缝集成以进行调试

安装

cd mcp-devspaces-logs
npm install
npm run build

配置

将此MCP服务器添加到您的Claude Code配置中:

适用于克劳德桌面

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "devspaces-logs": {
      "command": "node",
      "args": ["/path/to/devspaces-gateway-plugin/mcp-devspaces-logs/dist/index.js"]
    }
  }
}

适用于Claude Code CLI

如果服务器位于您的项目目录中,则应自动发现它,或者您可以将其添加到MCP设置中。

用法

配置后,Claude可以使用 get_remote_dev_server_exceptions 该工具用于从远程开发服务器Pod中检索Java异常和错误。

刀具参数

  • pod_pattern (可选):与pod名称匹配的模式(默认:“workspace”)
  • ide_dir (可选):IDE目录名称(例如,“IntelliJIdea2025.2”、“PyCharm2024.3”)。如果未提供,则自动检测。
  • log_file (可选):日志文件名(默认:“idea.Log”)
  • since_timestamp (可选):仅显示此时间戳后的日志中的错误(格式:“YYYY-MM-DD HH:MM:SS,mmm”)。如果未提供,则显示所有错误。

Claude使用示例

Get the exceptions from my remote dev server pod

克劳德将:

  1. 找到与“workspace*”匹配的pod
  2. 自动检测IDE目录
  3. 筛选Java异常和错误的日志文件
  4. 分析任何堆栈痕迹或错误

高级用法

Get exceptions from pod matching "my-workspace"
Get exceptions from PyCharm pod since a specific timestamp

先决条件

  • kubectl 必须安装并配置访问OpenShift集群的权限
  • 当前kubectl上下文必须设置为具有Dev Spaces Pod的集群
  • 足够的权限执行到Pod中

运作原理

  1. 用途 kubectl get pod 使用grep查找与模式匹配的Pod
  2. 通过列表自动检测IDE目录 ~/.cache/JetBrains/ pod中的目录
  3. 执行 kubectl exec 检索并筛选Java异常和错误的日志文件
  4. 返回筛选后的异常供Claude分析

发展

构建

npm run build

观看模式

npm run watch

许可证

阿帕奇-2.0