使用说明（简明实用版本）

• 项目简介 Crackerjack 内置的 MCP 服务器用于对接大型语言模型客户端（如 Claude 等），提供统一的接口来读取和管理资源、注册与执行工具，以及提供可渲染的 prompt 模板，形成一个标准化的后端上下文服务。

• 主要功能点

  1. 资源管理：托管和访问可供 LLM 客户端使用的资源数据，确保数据的可控与高效读取。
  2. 工具注册与执行：注册外部功能工具，LLM 客户端可通过接口调用执行。
  3. Prompt 模板定义与渲染：提供可定制的 Prompt 模板，支持动态上下文渲染以适配不同对话场景。
  4. JSON-RPC 通信：服务器端通过标准的 JSON-RPC 处理请求并返回响应或通知。
  5. 会话与能力管理：支持会话维持、能力声明，以及对多传输协议的支持。
  6. 多传输协议支持：包括 WebSocket，StdIO，SSE 等，方便不同客户端接入。

• 安装步骤

  1. 确保 Python 3.13+ 环境已经就绪。
  2. 使用项目的包管理与依赖工具安装必要依赖。
  3. 运行 MCP 服务器：通过 Crackerjack 提供的入口启动命令来启动 MCP 服务，默认监听在本地地址和端口。

• 服务器配置（MCP 客户端所需信息） 配置信息用于 MCP 客户端连接并使用 Crackerjack 的 MCP 服务器。JSON 结构示例（仅为说明，不直接执行）如下： { "server_name": "crackerjack", "command": "uvx", "args": [ "crackerjack", "--start-mcp-server" ], "notes": "启动 Crackerjack 的 MCP 服务器，提供 WebSocket 进度流与 JSON-RPC 接口。" } 说明：

  • server_name：在 MCP 客户端配置中引用的服务器标识名称，建议与实际服务器实现中的名称保持一致。
  • command / args：启动服务器的命令及参数，确保与开发环境或部署环境一致。
  • 本 MCP 客户端配置仅用于描述连接信息，实际连接由客户端发起，Crackerjack 服务器端无需额外客户端代码。

• 基本使用方法

  1. 启动 MCP 服务后，服务器将对外暴露 JSON-RPC 接口以及 WebSocket 端点，供客户端请求资源、调用工具、获取 Prompt 等。
  2. 客户端可通过发送符合 MCP 的请求格式完成资源读取、工具调用、Prompt 渲染等操作，以及通过 WebSocket 端点接收实时进度通知。
  3. 服务器负责会话管理、能力声明，以及对传输协议的支持和安全控制。
  4. 在需要时，可以通过客户端配置或服务器端命令调整能力、资源、工具和模板设置。