项目简介: HowToCook MCP 服务器 Kotlin版是一个基于Model Context Protocol (MCP) 标准实现的后端服务,它将开源菜谱项目《如何烹饪》的数据转换为可供大型语言模型 (LLM) 客户端访问的资源。通过集成菜谱数据、提供工具能力和定义Prompt模板,帮助LLM客户端(如AI助手)理解和利用这些信息,为用户提供菜谱推荐和餐点计划等服务。

主要功能点:

  • 菜谱数据访问: 以结构化方式向LLM提供《如何烹饪》中的海量菜谱数据。
  • 餐点规划工具: 提供调用外部功能的能力,例如根据用户需求和偏好生成一日三餐的餐点计划。
  • Prompt生成: 支持根据菜谱数据和规划结果生成适合LLM理解和输出的文本内容(如详细菜谱、周食谱)。
  • MCP协议通信: 通过Stdio等传输协议与LLM客户端进行标准的JSON-RPC通信。

安装步骤:

  1. 确保你已安装Java Development Kit (JDK) 17或更高版本。
  2. 确保你已安装构建工具 Maven 或 Gradle。建议使用Gradle。
  3. 克隆项目仓库到你的本地:'git clone https://github.com/RemindPan/how-to-cook-mcp-kotlin.git'
  4. 进入项目目录:'cd how-to-cook-mcp-kotlin'
  5. 使用Gradle构建项目:'./gradlew build'
  6. 构建成功后,你会在 'build/libs' 目录下找到可执行的JAR文件,例如 'how-to-cook-mcp-kotlin-all.jar'。你可以通过 'java -jar build/libs/how-to-cook-mcp-kotlin-all.jar' 命令手动运行服务器(通常用于测试),但在与MCP客户端集成时,客户端会负责启动。

服务器配置: MCP客户端连接此服务器时,需要配置服务器的启动信息。以下是一个示例配置(JSON格式),请注意这只是一个示例,实际配置可能需要根据你的MCP客户端界面进行填写。

{
  "name": "HowToCook MCP Server", // 服务器显示名称
  "command": "java", // 启动服务器的命令
  "args": [ // 启动命令的参数列表
    "-jar",
    "path/to/your/how-to-cook-mcp-kotlin-all.jar" // 替换为你的JAR文件实际路径
    // 这里可能会有可选参数,例如端口、日志级别等,具体取决于服务器实现
  ],
  "transport": "stdio" // 通信协议,此实现目前支持Stdio
}

MCP客户端只需要提供以上信息即可启动并连接MCP服务器,无需手动运行JAR文件。

基本使用方法: 作为MCP服务器,它主要由支持MCP协议的LLM客户端或AI应用调用。一旦客户端配置并连接成功,AI助手即可通过标准的MCP请求(如 'context/get' 获取菜谱、 'tool/execute' 执行规划、 'prompt/render' 生成文本)来访问服务器提供的菜谱数据和功能,并利用这些信息与用户进行关于烹饪、菜谱和餐点计划的交互。用户通过与AI助手交流来间接使用此服务器。

信息

分类

AI与计算