MCP Steroid

使用说明内容(Markdown格式)

  • 项目简介

    • MCP Steroid 是一个面向 AI 代理的后端服务器,基于 Model Context Protocol (MCP),旨在把 IntelliJ 平台的资源与能力以标准化的方式暴露给 MCP 客户端,支持资源管理、工具执行和提示渲染等核心能力。
  • 主要功能点

    • 提供 9 种 MCP Tools,用于在 IDE 中执行任务、查询信息、打开/管理项目等。
    • 提供 58 种 MCP Resources,覆盖文档、操作、调试、测试、VCS、工作流等各类能力与示例。
    • 支持可观测的视觉与 UI 能力(如屏幕截图、OCR、组件树分析等)以及 IDE 内部 API 的访问。
    • 基于 Kotlin/Java、Ktor HTTP 服务器、SSE 传输,遵循 MCP 协议进行 JSON-RPC 交互。
    • 支持多传输协议(HTTP、SSE),以及对话会话与能力声明等 MCP 框架特性。
  • 安装步骤

    1. 获取代码并构建:在具备 Java 21 环境的机器上,将代码仓库克隆并使用构建工具(如 Gradle)构建得到可运行的服务包。
    2. 运行服务器:以 Java 启动命令运行生成的可执行包,默认监听端口 6315,绑定地址为 127.0.0.1(可通过配置修改)。
    3. 配置 MCP 客户端:MCP 客户端需要提供服务器启动命令及参数,以便与 MCP 服务器建立连接。
    4. 连接与验证:启动后,MCP 客户端应使用提供的服务器地址与端口进行连接,并进行能力自发现与资源访问测试。
  • 服务器配置(JSON 配置,用于 MCP 客户端的启动信息) 说明:以下配置用于 MCP 客户端在启动时告知服务器的启动命令及参数等信息,便于快速建立连接。具体参数可按实际部署调整。 { "serverName": "MCP Steroid", "command": "java", "args": ["-jar", "mcp-steroid.jar", "--port", "6315", "--host", "127.0.0.1"], "description": "MCP Steroid 服务器的启动命令及参数,用于 MCP 客户端在本地启动并连接。默认端口6315,默认绑定127.0.0.1。若需要在 Docker/远端部署,请相应修改 host 与 port。" }

  • 基本使用方法

    • 启动后:确保服务器在指定端口运行,MCP 客户端可以通过服务器地址与端口建立连接,开始读取资源、调用工具、获取提示等。
    • 使用流程:客户端发送 MCP JSON-RPC 请求,服务器返回相应的资源、工具执行结果或提示模板等信息。
    • 运行环境要求:Java 21 及以上、Kotlin 2.2.21,依赖 Kotlin/JVM 运行时与 Ktor 3.1.0。

服务器信息