mcpField
T
threadmine

threadmine

本地服务
github.com/maschiojv开发工具02 天前更新
代码仓库

关于 threadmine

threadmine 是用于 AI 助手的 Java 线程转储分析 MCP 服务，面向排查 JVM 运行问题的开发者。它返回检测到的问题、健康评分和交互式报告链接。

主要功能

  1. 01分析 JVM 线程转储
  2. 02检测死锁和 CPU 峰值
  3. 03发现线程池耗尽和虚拟线程固定
  4. 04返回健康评分及报告链接
  5. 05按 ID 获取既有分析

适用场景

  1. 01排查 JVM 应用死锁
  2. 02调查 CPU 峰值或线程池耗尽
  3. 03检查虚拟线程固定问题
  4. 04在聊天中查看先前分析结果

MCP 相关

MCP 服务向 AI 助手提供分析线程转储和按 ID 获取分析结果的工具。分析操作计入工作区每日配额，读取既有分析为只读操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "dev-threadmine": {
      "command": "npx",
      "args": [
        "-y",
        "@threadmine/mcp"
      ],
      "env": {
        "THREADMINE_API_KEY": "<THREADMINE_API_KEY>",
        "THREADMINE_API_URL": "<THREADMINE_API_URL>"
      }
    }
  }
}
启动命令npx -y @threadmine/mcp
需要配置的环境变量
THREADMINE_API_KEY密钥Optional. Without it, analyses run anonymously (5/hour per IP, report expires in 7 days)
THREADMINE_API_URLOverride the ThreadMine API endpoint (default: https://api.threadmine.dev)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@threadmine/mcp0.2.0

工具

2

收录的工具列表 · 更新于 2 天前

参数类型必填说明
titlestring否分析的可选标题
contentstring否原始线程转储文本（jstack / jcmd Thread.print / kill -3 的输出）
file_pathstring否线程转储文件的绝对路径——大型转储建议使用

详细介绍

ThreadMine MCP 服务

ThreadMine 是一款带 AI 的 Java 线程转储分析器，可检测死锁、CPU 峰值、线程池耗尽和虚拟线程固定问题。免费在线使用，无需注册。

ThreadMine 的官方 MCP 服务。将 JVM 线程转储粘贴到 AI 助手中——Claude Code、Claude Desktop 或 Cursor——即可获取检测到的问题、健康评分，以及完整交互式报告的链接，无需离开聊天界面。

工具

工具功能配额
analyze_thread_dump上传线程转储（内联文本或文件路径），并返回检测到的问题、健康评分（0-100）和报告链接每日配额中消耗 1 次分析
get_analysis按 ID 获取此前的分析结果免费（只读）

设置

  1. 在 threadmine.dev 创建免费账户。
  2. 在 Web 应用中，前往 Settings → API Keys 创建 API 密钥。
  3. 将服务添加到你的助手中：

Claude Code

claude mcp add threadmine -e THREADMINE_API_KEY=tf_live_xxx -- npx -y @threadmine/mcp

Claude Desktop / Cursor（claude_desktop_config.json / .cursor/mcp.json）

{
  "mcpServers": {
    "threadmine": {
      "command": "npx",
      "args": ["-y", "@threadmine/mcp"],
      "env": { "THREADMINE_API_KEY": "tf_live_xxx" }
    }
  }
}

使用方法

可以向助手提出如下问题：

  • “分析此线程转储：<paste>”
  • “使用 ThreadMine 分析 /tmp/threaddump.txt 中的转储”
  • “ID 为 <id> 的分析发现了什么？有没有死锁？”

注意事项

  • 分析会在 API 密钥所属的工作区中运行，并计入该工作区套餐的配额（免费套餐包含每日配额 — 定价）。
  • THREADMINE_API_URL 可用于覆盖 API 端点（可自托管／暂存环境）。
  • 需要 Node.js ≥ 20。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。