使用说明（Markdown 格式）

项目简介

GTM MCP Server 是一个基于 MCP（Model Context Protocol）的后端服务器实现，负责托管资源（Resources）、注册并执行工具（Tools）、定义与渲染 Prompt 模板（Prompts），并通过 JSON-RPC 协议与客户端进行请求/响应交互。服务器端负责会话管理、能力声明，以及对不同传输协议的支持，旨在为 LLM 客户端提供安全、可扩展的上下文服务框架。

主要功能点

MCP 服务端核心能力
- 处理资源相关请求：列出资源、读取资源内容
- 处理工具相关请求：列出可用工具、执行工具调用
- 处理 Prompts 相关请求：列出 Prompt、获取 Prompt 详情
UI 资源与集成
- 内置一组 UI 资源（如 Email、LinkedIn、Lead Profiles 等），可供 MCP 应用在 Claude Desktop 等环境中使用
传输与会话
- 基于 JSON-RPC 的通信协议实现，支持多传输接口的扩展（示例实现为 Stdio，后续可扩展 SSE/WebSocket 等）
插件式集成
- 提供 HubSpot 等外部服务工具的扩展点（在 MCP 服务端内实现工具调用路径）
模板与数据结构
- 定义了输入 schemas（如 ListToolsRequest、ReadResourceRequest、ListPromptsRequest 等），用于规范化请求参数
安全与部署
- 服务器端实现了对资源与工具的标准化暴露，且包含对配置、凭证等的可控扩展点

安装与运行步骤

获取代码与依赖
- 将代码仓克隆到本地/服务器
- 使用常规前端/后端项目的依赖安装流程安装所需依赖
构建与启动
- 构建阶段产出 dist/index.js（服务器端入口）
- 启动命令示例（实际使用时请参考项目内的启动脚本与环境配置）
  - 运行方式示例：npx gtm-mcp-server
运行注意
- MCP 客户端需要按照配置提供服务端的名称以及启动命令参数，以建立连接
- 部署过程中可通过环境变量开启/配置对外服务（如 API 密钥、集成开关等）

服务器配置（给 MCP 客户端使用的配置示例说明）

说明：MCP 客户端需要一个 JSON 配置，指定启动的 MCP 服务器名称、启动命令与参数等，以便在运行时自动连接到服务器。以下为字段说明，非代码块形式呈现，确保易于理解。

server: 服务器标识名称，建议与 MCP 服务端“name”字段一致，例如 gtm-mcp-server。
command: 启动服务器所需的执行命令，例如 "npx"。
args: 启动命令的参数数组，例如 ["gtm-mcp-server"]。
备注：该配置仅用于 MCP 客户端端连接服务器的启动信息，实际实现的运行逻辑在服务端，客户端仅需要知道如何启动并连接即可。

示例（以文本形式描述的 JSON 结构）： { "server": "gtm-mcp-server", "command": "npx", "args": ["gtm-mcp-server"] } 说明：以上信息为 MCP 客户端连接服务器所需的最小化描述，请按实际环境替换 server 名称与启动参数。

基本使用方法

启动服务器
- 使用提供的启动命令在客户端环境中启动服务器进程（如 npx gtm-mcp-server），服务器将通过指定传输接口（示例为 Stdio）对接 MCP 客户端。
客户端接入
- MCP 客户端按上述配置启动，并通过 JSON-RPC 向服务器发送请求，例如读取资源、列出工具、获取提示等，服务器返回标准化的 JSON-RPC 响应。
功能使用
- 客户端可请求资源、工具、Prompts 的清单及具体内容，服务器将返回相应的数据结构或文本内容。
集成与扩展
- 如需扩展外部工具（如 HubSpot、Claude 桌面等）的集成，按仓库内的集成代码与 API 约定实现对应的工具处理逻辑。

重要说明

MCP 客户端的配置不需要直接修改 MCP 服务器端代码，客户端仅需要正确的启动命令与参数即可建立连接。
服务器端已实现核心 MCP 请求处理逻辑，扩展点包括更多传输协议、更多资源/工具的接入，以及外部系统的工具实现。

适用场景

需要以标准化后端提供资源、工具与 Prompts，供 LLM 客户端调用并集成到更大工作流中的应用后端

补充说明

本实现包含对资源、工具、Prompts 的完整处理能力，以及 UI 资源的暴露，具备明确的 MCP 服务端职责边界并提供示例扩展点（如 HubSpot 集成）。
该实现符合 MCP 服务端应具备的核心能力与运行性要求，属于完整且可运行的 MCP 服务端实现。

GTM MCP Server