项目简介

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,简化工具调用时的参数输入。

安装步骤

  1. 克隆仓库

    git clone https://github.com/Godzillas/im-notifier.git
    cd im-notifier
  2. 安装依赖

    npm install
  3. 配置环境变量 复制 '.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" 章节的详细说明。

信息

分类

通信与社交