K米 MCP 工具使用指南

1. 项目介绍

K米 MCP 工具是一个帮助你与 K米服务器通信的桥梁，让你可以轻松调用 K米提供的各种功能，比如查询会员信息、创建优惠券、管理充值规则等。

1.1 主要功能

• 自动识别用户：支持微信、飞书等多种平台的用户登录
• 保持登录状态：自动保存登录信息，重启后无需重新登录
• 简单调用工具：通过命令行就能调用 K米的各种功能
• 支持多种平台：无论是微信、飞书还是 K米客户端，都能正常使用

1.2 适用人群

• 客服人员：快速查询会员信息
• 运营人员：创建和管理优惠券、充值规则
• 开发人员：集成 K米功能到其他系统

1.3 技术要求

• 电脑安装了 Node.js 16+ 和 npm
• 能够访问 K米服务器
• 基本的命令行操作知识

2. 快速开始

2.1 安装步骤

1. 准备环境：确保你的电脑安装了 Node.js 16 或更高版本
2. 获取代码：复制仓库地址并克隆到本地
3. 安装依赖：运行 npm install 命令安装所需的依赖包
4. 启动工具：在 OpenClaw 环境中加载该插件

2.2 基本使用方法

查看可用工具

如果你想知道有哪些功能可以使用，可以列出指定类别的所有工具：

km_mcp list 类别名称

示例：查看联系人相关的工具

km_mcp list contact

调用具体功能

当你知道要使用哪个功能后，可以通过以下命令调用：

km_mcp call 类别名称 功能名称 '参数'

示例：获取联系人信息

km_mcp call contact getContact '{}'

3. 功能详解

3.1 用户登录与识别

当你使用 K米 MCP 工具时，它会自动识别你是从哪个平台登录的（比如微信、飞书或 K米客户端），并提取你的用户信息，无需手动输入账号密码。

支持的登录平台

• 微信：通过微信账号登录
• 飞书：通过飞书账号登录
• K米客户端：直接使用 K米客户端登录

3.2 自动保持登录状态

工具会自动保存你的登录信息到本地文件，当你重启电脑或重新打开工具时，不需要重新登录，系统会自动恢复你的登录状态。

3.3 与 K米服务器通信

工具会与 K米服务器建立稳定的连接，确保你可以正常使用各种功能。即使网络暂时中断，工具也会在网络恢复后自动重新连接。

3.4 如何调用功能

当你需要使用某个功能时，只需要通过简单的命令行指令，就可以调用 K米服务器提供的各种工具，比如：

• 查询会员信息
• 创建优惠券
• 管理充值规则
• 处理订单

所有这些操作都可以通过命令行完成，无需复杂的编程知识。

4. 高级功能

4.1 支持更多登录平台

如果你需要支持除微信、飞书和 K米客户端之外的其他平台（比如钉钉、企业微信等），可以联系技术人员进行扩展。

4.2 自定义会话管理

如果你希望自定义登录状态的保持时间，或者添加其他会话管理功能，可以与技术人员沟通，根据你的需求进行定制。

4.3 集成到其他系统

如果你的企业有自己的系统，需要集成 K米的功能，可以通过 K米 MCP 工具提供的接口，将 K米的功能无缝集成到你的系统中。

4.4 常见问题解答

Q: 为什么我无法连接到 K米服务器？ A: 请检查你的网络连接，确保你可以访问 K米服务器。

Q: 登录状态会保持多久？ A: 默认情况下，登录状态会保持24小时，超过这个时间后需要重新登录。

Q: 我可以在哪些平台上使用这个工具？ A: 目前支持微信、飞书和 K米客户端，未来可能会支持更多平台。