Kit.com MCP Server (mcp-kit)

关键词

Kit.com APIAI 助手工具自动化营销外部数据访问云端上下文服务

使用说明

  • 项目简介

    • 这是一个基于 MCP（Model Context Protocol）标准的后端服务器实现，旨在让像 Claude、GPT 等大语言模型能够通过 MCP 客户端以统一、标准化的方式访问 Kit.com 的数据和功能。它把 Kit.com 的资源（账户、订阅、标签、序列、广播、表单、自定义字段、webhook 等）包装成 MCP Tool，供 LLM 调用。
    • 服务器通过命名并注册一组 Tool，使 LLM 可以以自然语言请求相应的操作，如列出订阅者、创建订阅者、管理标签、发送广播等，并将结果以 MCP 规定的 Content 结构返回给客户端。

  • 主要功能点

    • Tool 注册与执行：将 Kit.com 的各类操作暴露为 MCP Tool，LLM 调用时返回结构化数据。
    • 资源访问：读取账户信息、订阅者、标签、序列、广播、表单、自定义字段、Webhooks 等资源，支持必要的筛选与分页参数。
    • 外部功能调用：通过 Kit.com API v4 实现对外部系统的实际调用，返回统一的响应格式。
    • 会话与能力声明：提供服务端会话管理与能力描述，便于客户端发现可用能力。
    • 传输与部署：默认使用 Stdio 传输，便于本地开发、测试与与其它 MCP 客户端集成；可拓展到 WebSocket、SSE 等传输。

  • 安装步骤

    • 确保使用 Node.js 18 及以上版本。
    • 通过 npm 运行服务器（推荐）：
      • npx kit-mcp-server
      • 也可全局安装后直接运行: npm install -g kit-mcp-server
    • 如果选择从源码运行：
      • 克隆仓库并安装依赖：git clone https://github.com/aplaceforallmystuff/mcp-kit.git cd mcp-kit npm install npm run build
    • 运行服务器之前，请确保获得 Kit.com 的 API Key，并设置环境变量 KIT_API_KEY（后续客户端连接时需要此密钥来进行 API 调用）。
    • 启动服务器后，默认通过标准输入输出（Stdio）与客户端通信，适用于本地调试与集成测试。

  • 服务器配置（MCP 客户端需要的连接信息）

    • 该部分用于 MCP 客户端（如 Claude）在配置中连接到本 MCP 服务器。以下字段描述服务器信息与启动参数，便于客户端正确连接并启动服务器进程：
    • server name：mcp-kit
    • command：node
    • args：“dist/index.js”（假设已构建到 dist 目录；实际路径请根据部署位置调整）
    • env：包含 KIT_API_KEY，用于 Kit.com API 的鉴权
    • 说明：MCP 客户端只需要知道如何启动/连接到服务器即可，不需要实现服务端逻辑，参数请确保与实际部署路径和环境一致
    • 示例描述（以文本形式展示，非代码块）：{ "name": "mcp-kit", "command": "node", "args": ["dist/index.js"], "env": { "KIT_API_KEY": "your-api-key" } }

  • 基本使用方法

    • 将 MCP 客户端（如 Claude）配置为连接到该 MCP 服务器，提供启动命令与参数，以及 KIT_API_KEY 的环境变量。
    • 启动后，LLM 客户端可以按自然语言请求工具，例如：
      • “列出我的订阅者”
      • “将用户加入某个序列”
      • “创建一个标签并将订阅者标记为 VIP”
    • 服务器会将请求路由到对应的 KitClient 调用，返回 MCP 内容格式的数据，LLM 可进一步在对话中渲染或处理结果。

  • 兼容性与扩展

    • 当前实现支持多种资源与工具的暴露，未来可增加更多 Kit.com API 的端点。
    • 服务器端与客户端之间通过 JSON-RPC 及 MCP 内容格式进行交互，便于与多种语言与框架集成。

服务器信息

访问项目