Kiln MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • Kiln 是一个 MCP 服务器端实现，提供统一的后端上下文服务，用于向 AI/LLM 客户端提供资源、工具与 Prompts，并支持以多种传输协议进行通信，确保安全可扩展的后端服务。

• 主要功能点

  • 资源管理与数据访问：托管与管理可读写的资源，诸如系统快照、队列、打印状态等，供客户端读取或订阅通知。
  • 工具注册与执行：暴露大量 MCP 工具，LLM 可通过 JSON-RPC 调用外部功能（例如查询打印状态、下发任务、获取材料/价格等）。
  • Prompt 模板定义与渲染：支持自定义的提示模板及对话模式渲染，帮助对接不同模型的交互风格。
  • JSON-RPC 通信：服务器接收客户端请求并返回标准的 JSON-RPC 响应或通知。
  • 会话与能力声明：管理会话、能力清单、权限控制（可选 API Key、作用域等）。
  • 多传输协议支持：如 STDIO、SSE、WebSocket 等，确保与不同客户端的连接灵活性。
  • 拓展性与集成：内置插件、适配不同打印机后端与外部服务（市场、 fulfillment 等），易于接入新的资源、工具和适配器。

• 安装步骤

  • 克隆仓库并安装开发版本（推荐）
    • 通过 Python 环境安装本仓库中的 kiln 包及其开发模式，以启用本地开发和测试。
  • 安装依赖
    • 需要 Python 及相关依赖，建议使用虚拟环境安装完整依赖集。
  • 运行 MCP 服务器
    • 使用 kiln 的命令启动 MCP 服务器（例如 kiln serve），默认会从本地配置加载打印机信息。
  • 测试与验证
    • 确保 MCP 客户端能够通过 JSON-RPC 调用 Kiln 提供的资源、工具与提示模板。

• 服务器配置（MCP 客户端需要配置信息）

  • 服务器配置示例（用于 MCP 客户端连接） { "server_name": "kiln", "command": "kiln", "args": ["serve"], "description": "Kiln MCP server", "notes": "客户端在连接时可使用该服务器名称、命令与参数来启动与连接 MCP 服务。" }
  • 配置要点
    • server_name：服务器名称，与客户端在集成时引用的名称一致。
    • command：启动服务器的命令名称，一般为 Kiln 的 CLI 主入口命令。
    • args：启动服务器所需的参数，通常为 ["serve"]，用于启动 MCP 服务。
    • 该配置仅供 MCP 客户端了解如何连接服务器；客户端并不需要运行服务器，只需要知道服务器的启动命令和参数以建立连接。

• 基本使用方法

  • 启动与连接
    • 在服务器端运行 Kiln 的 MCP 服务（如 kiln serve），保持服务持续运行。
    • 在 MCP 客户端配置中指定服务器名称、启动命令及参数，以建立 JSON-RPC 通信。
  • 使用场景
    • 通过 MCP 工具调用（如读取资源、执行工具、获取 Prompt）实现对打印、市场、生成等流程的自动化控制。
  • 典型工作流
    • LLM 调用工具查询打印状态、获取材料、下发任务、生成模型等；服务器负责执行并返回结构化的结果或通知。