关键词

tarottooljson-rpcmcp toolkitserver
  • 项目简介
    • 该仓库中存在一个基于 MCP Toolkit 的服务器实现样例，名为 tarot-engine-mystic，使用 MCP 提供的 serveMCP 入口注册服务器、暴露工具（actions）用于 LLM 调用。核心思路是把“塔罗牌解读”作为对外暴露的工具集，通过统一的 JSON-RPC 风格请求向 LLM 客户端提供服务，同时在服务端可扩展资源、提示模板等能力以支持更丰富的交互模式。
  • 主要功能点
    • 工具注册与执行：通过 actions.register 的方式暴露 drawSpread（生成牌阵）和 logReading（记录解读）等工具，LLM 客户端可调用。
    • 任务化调用：客户端通过 MCP 的 JSON-RPC 请求，与服务器进行任务下发与结果获取，便于将塔罗引擎与记忆/日志系统解耦。
    • 扩展性能力：示例中可扩展为更多工具、资源与 Prompt 模板，便于实现更丰富的对话模式与上下文管理。
    • 服务器运行与对接：服务器端代码通过 MCP Toolkit 启动，处理来自 LLM 客户端的请求，返回 JSON-RPC 响应。
  • 安装与运行
    • 依赖环境：Node.js 运行环境，推荐使用现代 Node 版本。
    • 启动方式：直接运行 tarot engine 脚本（tarot-engine-mystic/index.js），可用以下方式之一启动：
      • 直接执行：node _quarantine/legacy-agents/tarot-engine-mystic/index.js
      • 作为可执行脚本：将文件设为可执行并直接执行
    • 运行时行为：服务器注册为 MCP 服务，客户端通过 MCP 协议调用 drawSpread、logReading 等动作。
  • 服务器配置（供 MCP 客户端的启动或对接使用）
    • serverName: "tarot-engine-mystic"
    • command: "node"
    • args: ["_quarantine/legacy-agents/tarot-engine-mystic/index.js"]
    • description: "Tarot MCP Server for Mystic Arcana" 说明：以上为 MCP 客户端对接所需的启动配置示例，实际路径请以部署时的实际路径为准。客户端无需依赖该配置文件的实现细节，但需要了解服务器的启动命令和参数以便建立连接。
  • 基本使用方法
    • 客户端可以通过 MCP 发起 JSON-RPC 请求来调用 drawSpread，指定牌阵类型（如 three-card、celtic-cross 等），服务器返回牌阵结果及绘制信息。
    • 客户端可以通过 logReading 将牌阵解读与相关元数据记录到服务器，便于后续分析、记忆与个性化推荐。
    • 如需扩展：可以在服务器端继续注册新的 Tools、资源（Resources）与促使 Prompt 模板，支持多轮对话中的上下文渲染。

信息

分类

AI与计算

访问项目