使用说明

• 项目简介
  • cctelepathy 是一个基于 MCP（Model Context Protocol）的后端服务器实现，旨在向 LLM 客户端（如 Claude Code 等）提供统一的资源数据、可调用的工具，以及可渲染的 Prompt 模板，便于实现多实例协作、任务协作与工作上下文传递。
• 主要功能点
  • 资源管理：托管和管理可供 LLM 客户端读取的数据资源（Resources），提供统一的数据访问入口。
  • Tools 注册与执行：注册多种 Tools，允许 LLM 客户端通过 JSON-RPC 调用外部功能，获取结果并渲染到对话中。
  • Prompts 定义与渲染：支持 Prompts 的规范化定义与渲染，方便与 LLM 的对话模式整合。
  • 会话与状态管理：包含会话管理、上下文传递和跨会话隔离设计，确保不同客户端的上下文独立性。
  • 多传输协议支持：通过 MCP 框架提供的传输能力，理论上可切换到 Stdio、SSE、WebSocket 等传输方式，便于不同环境的部署。
  • JSON-RPC 风格通信：服务器对外通过 MCP 约定的 JSON-RPC 风格请求与响应进行交互，保持一致性与可扩展性。
• 安装步骤
  • 下载源码后，在项目根目录执行依赖安装，随后进行构建与打包。
  • 运行服务器（示例，视你实际部署方式而定）：
    • 直接以 MCP 服务器方式启动并监听传输，或通过内置的 stdio 传输启动，供 MCP 客户端接入。
• 服务器配置（MCP 客户端需要的配置示例，描述仅用于帮助理解，不需要直接操作服务器代码）
  • 服务器名称：telepathy
  • 启动命令（command）：npx
  • 启动参数（args）：cctelepathy
  • 说明：该配置用于 MCP 客户端在连接服务器时指定要连接的服务器名称及启动方式。客户端需要的仅是服务器名称、启动命令与参数，以便能够通过 MCP 客户端与服务器建立连接并进行资源、工具及 Prompts 的交互。
• 基本使用方法
  • 启动与连接：启动 MCP 服务器后，客户端通过配置的启动命令与参数连接到 Telepathy MCP 服务器，建立 JSON-RPC 通道。
  • 资源与工具交互：客户端通过 MCP 提供的规范接口读取资源、调用工具、获取 Prompts，并按照约定的 JSON-RPC 请求/响应格式进行交互。
  • 会话与上下文：服务器维护会话状态，按需渲染上下文信息到 LLM 的对话中，支持多客户端协作与任务跟踪。