项目简介
IM Notifier MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,旨在为大型语言模型(LLM)提供向中国流行的企业即时通讯平台发送消息通知的能力。通过此服务器,LLM 可以方便地将信息推送至飞书 (Feishu/Lark)、钉钉 (DingTalk) 和企业微信 (WeChat Work)。
主要功能点
- 消息发送工具: 提供 'feishu_send', 'dingtalk_send', 'wechatwork_send' 和 'send_message' 等工具,允许 LLM 通过调用这些工具向不同的即时通讯平台发送文本或卡片消息。
- 多平台支持: 支持飞书、钉钉和企业微信三大平台,覆盖主流企业通讯需求。
- 灵活的消息格式: 支持发送纯文本消息,以及平台特定的富文本消息格式,例如飞书的交互式卡片和钉钉的 Markdown 消息。
- 通用工具: 提供 'send_message' 通用工具,可以根据 Webhook URL 自动检测平台类型并发送消息。
- 默认 Webhook 配置: 支持在 '.env' 文件中配置默认的 Webhook URL,简化工具调用时的参数输入。
安装步骤
-
克隆仓库
git clone https://github.com/Godzillas/im-notifier.git cd im-notifier -
安装依赖
npm install -
配置环境变量 复制 '.env.example' 文件并重命名为 '.env',根据需要配置默认的 Webhook URL。
cp .env.example .env在 '.env' 文件中,您可以设置以下环境变量(可选):
FEISHU_WEBHOOK=您的飞书Webhook地址 DINGTALK_WEBHOOK=您的钉钉Webhook地址 WECHATWORK_WEBHOOK=您的企业微信Webhook地址
服务器配置
要将 IM Notifier MCP Server 集成到 MCP 客户端(如 Claude Desktop),您需要在客户端的 MCP 配置中添加以下服务器信息。以 'claude_desktop_config.json' 或 '.codeium/windsurf/mcp_config.json' 文件为例:
{ "mcpServers": { "im-notifier": { "command": "node", "args": ["/path/to/im-notifier/server.js"] } } }
配置参数说明:
- 'server name': 'im-notifier' (服务器名称,可以自定义)
- 'command': 'node' (启动服务器的命令,这里使用 Node.js)
- 'args': '["/path/to/im-notifier/server.js"]' (启动命令的参数,指向 'server.js' 文件的路径,请替换为实际路径)
基本使用方法
配置完成后,MCP 客户端(如 Claude)将能够发现并调用 IM Notifier MCP Server 提供的工具。您可以通过自然语言指令指示 Claude 使用 'feishu_send', 'dingtalk_send', 'wechatwork_send' 或 'send_message' 工具来发送消息。
工具调用示例 (以 'send_message' 为例):
假设您希望 Claude 发送消息到指定的 Webhook URL,您可以指示 Claude 执行类似以下操作:
使用 'send_message' 工具,webhook URL 是 '[您的Webhook URL]', 消息内容是 '[您要发送的消息]'
或者,如果您配置了默认的 Webhook URL,并且希望使用默认平台发送消息,您可以更简洁地指示:
使用 'send_message' 工具,消息内容是 '[您要发送的消息]'
具体的工具参数和使用方式,请参考仓库 README.md 文件中 "Available Tools" 章节的详细说明。
信息
分类
通信与社交