SalesIQ 上下文服务端
- 项目简介
- 该仓库实现了一个基于 Model Context Protocol (MCP) 的服务器端，核心职责是向客户端提供资源访问、工具执行和提示模板渲染等能力。服务器通过 JSON-RPC 与客户端通信，支持会话管理和能力声明，采用标准化的数据模型组织资源、工具与提示信息，并在标准输出/输入（stdio）等传输通道上工作。实现目标是为 Claude Code 等 LLM 客户端提供可扩展的上下文服务框架。
- 主要功能点
- 资源管理与访问：定义并暴露一组资源（如管道、联系人等），支持列出、读取和读取结果的接口，便于 LLM 客户端查询实时数据。
- 工具注册与执行：聚合多类外部工具（如 CRM、邮件、分析、内容日历等），实现按名称执行、传参与返回结构化结果的能力，支持错误与空返回处理。
- 提示模板与对话渲染：提供用于对话的提示模板和示例，便于 LLM 客户端在对话中嵌入结构化指令与上下文。
- 会话与能力声明：在启动时注册自身能力（工具、资源、提示），并通过传输协议向客户端披露可用能力。
- 传输协议支持：默认使用标准输入/输出（stdio）进行通信（也具备通过一致的接口扩展传输通道的能力），满足 MCP 服务器的基本传输需求。
- 安全与集成：集成外部数据源（如 CRM、分析平台等）的“模拟”实现，实际生产中可对接真实 API；当前实现提供了键/限值等简单校验和错误返回路径。
- 安装与运行（简要）
- 需要 Node.js 20+ 环境，依赖项将通过构建过程安装与打包。
- 构建与运行的典型命令（不涉及具体代码展示）：
- 构建并打包后，通过 npx 或全局安装运行 MCP 服务器，例如 npx @bienhoang/sales-iq-mcp-server，或在开发环境直接执行打包后的可执行入口。
- 运行后服务器将通过标准输入输出进行 MCP 交互，向客户端提供 Tools、Resources、Prompts 等能力。
- 服务器配置（供 MCP 客户端参考，JSON 表示，客户端需配置即可与服务器建立连接） { "serverName": "sales-iq", "command": "npx", "args": ["@bienhoang/sales-iq-mcp-server"], "description": "SalesIQ MCP 服务端，用于 Claude Code 等 LLM 客户端的上下文数据与工具能力接入" } 说明：该配置对应仓库中 MCP 服务的默认启动方式，客户端在实现对接时需要提供服务器名称、启动命令及参数以建立 JSON-RPC 交互通道。实际使用时可将 serverName、command、args 替换为你的部署信息。
- 基本使用方法
- 客户端通过 MCP 协议向服务器发送 JSON-RPC 请求，以读取资源、执行工具、获取提示等能力；服务器返回结构化的 JSON-RPC 响应或通知。
- 常见操作场景包括：
- 列出可用资源、工具、提示模板
- 读取特定资源的内容或结果
- 调用指定工具并获取执行结果
- 获取并渲染指定的提示模板
- 集成步骤大致为：1) 启动 MCP 服务器；2) 客户端（LLM）通过标准化的请求格式与服务器通信；3) 服务器返回标准化的响应，客户端据此生成或改写对话内容。