星战科技xingzhan.cloud
返回市场
公告通知MCP服务器

公告通知MCP服务器

作者：Wangnov2 星标更新：2025-09-26
安装使用来源：spider==github.com

项目介绍

gewe-notice-mcp

<p align="center"> <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"/> <img src="https://img.shields.io/github/v/release/wangnov/gewe-notice-mcp?label=release" alt="Release"/> <img src="https://img.shields.io/npm/v/gewe-notice-mcp.svg" alt="npm Version"/> <img src="https://img.shields.io/badge/rust-1.75%2B-orange.svg" alt="Rust"/> <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-success.svg" alt="Platforms"/> </p>

通过 Gewe API 提供的微信机器人任务通知MCP服务器是使用Rust构建的。

✨ 功能亮点

  • ⚡ 原生性能 单个本地二进制进程，无需Node运行时。
  • 🌍 跨平台 官方提供预构建包，支持macOS（Intel/ARM）、Linux（glibc/musl）和Windows。
  • 🛠️ 易于部署 您可以手动下载或继续使用传统的Node.js通过npx。
  • 屏蔽 智能容错
    • 自动检索群组成员昵称，使@消息更易读。
    • 自动跳过无效的wxid并打印警告。
    • 当群组成员列表检索失败时，降级为纯文本以确保消息传递。
    • 当所有成员缺乏足够权限时，自动重试为普通消息。

📸 渲染图像

<table> <tr> <td align="center">个人通知效果</td> <td align="center">群@通知效果</td> </tr> <tr> <td><img src="https://gips2.baidu.com/it/u=291612797,358028606&fm=3081&app=3081&f=PNG?w=1490&h=200" width="350"></td> <td><img src="https://gips2.baidu.com/it/u=2105389699,3666440223&fm=3081&app=3081&f=PNG?w=1482&h=200" width="350"></td> </tr> </table>

场景描述

gewe-notice-mcp 的设计初衷是为了作为单向、非交互式的状态通知工具：

  • 单向通知（此工具） 核心价值在于无人值守的场景：当您的AI代理在执行耗时任务（如服务器上的代码生成、数据分析、自动化测试等）时，可以通过微信主动推送关键节点的状态给您。这是一种“发送即忘”的通知机制，不会中断代理的执行过程。

  • 交互工具（其他） 代理的执行流程会显式暂停等待用户输入来决定下一步行动。

简单来说：如果您需要代理通知您发生了什么，请使用此工具。如果您需要代理询问如何进行，请使用交互工具。

建议在用户规则、项目规则或代理规则中固化这些区分概念，避免多工具涉及时产生冲突。

🚀 安装方法

方法1：下载预构建二进制文件（推荐）

选择适合您系统的版本：

<details> <summary><b>🍎 macOS (Apple Silicon M1/M2/M3)</b></summary> 
# 下载 ARM64 版本
curl -L -o gewe-notice-mcp.tgz \
  https://github.com/wangnov/gewe-notice-mcp/releases/latest/download/gewe-notice-mcp-darwin-arm64.tgz

# 解压文件
tar -xzf gewe-notice-mcp.tgz

# 添加执行权限
chmod +x gewe-notice-mcp

# 移动到 PATH 目录（可选）
sudo mv gewe-notice-mcp /usr/local/bin/

# 验证安装
gewe-notice-mcp --version
</details> <details> <summary><b>🍎 macOS (Intel)</b></summary> 
# 下载 x64 版本
curl -L -o gewe-notice-mcp.tgz \
  https://github.com/wangnov/gewe-notice-mcp/releases/latest/download/gewe-notice-mcp-darwin-x64.tgz

# 解压文件
tar -xzf gewe-notice-mcp.tgz

# 添加执行权限
chmod +x gewe-notice-mcp

# 移动到 PATH 目录（可选）
sudo mv gewe-notice-mcp /usr/local/bin/

# 验证安装
gewe-notice-mcp --version
</details> <details> <summary><b>🐧 Linux (x64)</b></summary> 
# 下载 Linux x64 版本
curl -L -o gewe-notice-mcp.tgz \
  https://github.com/wangnov/gewe-notice-mcp/releases/latest/download/gewe-notice-mcp-linux-x64.tgz

# 解压文件
tar -xzf gewe-notice-mcp.tgz

# 添加执行权限
chmod +x gewe-notice-mcp

# 移动到 PATH 目录（可选）
sudo mv gewe-notice-mcp /usr/local/bin/

# 验证安装
gewe-notice-mcp --version
</details> <details> <summary><b>🪟 Windows (x64)</b></summary>

PowerShell:

# 下载 Windows x64 版本
Invoke-WebRequest -Uri "https://github.com/wangnov/gewe-notice-mcp/releases/latest/download/gewe-notice-mcp-win32-x64.tgz" -OutFile gewe-notice-mcp.tgz

# 使用 tar 解压（Windows 10+ 内置）
tar -xzf gewe-notice-mcp.tgz

# 移动到合适的目录
New-Item -ItemType Directory -Force -Path "C:\Program Files\gewe-notice-mcp"
Move-Item -Force gewe-notice-mcp.exe "C:\Program Files\gewe-notice-mcp\"

# 添加到 PATH（需要管理员权限）
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\gewe-notice-mcp", [EnvironmentVariableTarget]::Machine)

# 验证安装（新开一个终端）
gewe-notice-mcp --version

Command Prompt (CMD):

:: 下载 Windows x64 版本
curl -L -o gewe-notice-mcp.tgz https://github.com/wangnov/gewe-notice-mcp/releases/latest/download/gewe-notice-mcp-win32-x64.tgz

:: 解压文件
tar -xzf gewe-notice-mcp.tgz

:: 验证安装
gewe-notice-mcp.exe --version
</details>

方法2：兼容npx

参见MCP客户端配置指南

建议逐步迁移到Rust版本二进制文件，以获得更好的性能和维护体验。

⚙️ 先决条件

开始之前，您需要从您的微信管理页面访问Gewe API管理后台，从中文文本中获取以下信息：

  1. Base_Url 默认情况下不需要配置，已经设置为http://api.geweapi.com 如果Gewe通知您Base_Url发生变化，您可以通过管理后台用户首页 - 激活信息 查看API接口域名 如果您使用的是私有部署的Gewe API服务，请将其设置为相应的服务器域名或IP地址。
  2. API Token 用于认证X-GEWE-TOKEN
  3. App ID 您的微信机器人实例的appId
  4. 接收者WXID 您的个人微信ID用于接收通知（wxid_...）或群聊ID（..._chatroom）。
  5. (可选) @对象的WXID 如果您想在群聊中@特定人员，需要提前告知他们的wxid 或者直接输入all @所有人（需要管理员或群主权限）。

关于如何获取他人或群聊的wxid，您需要自行测试，例如：启动一个HTTP服务来接收来自Gewe API的回调消息。然后在官方微信客户端中向您的微信机器人发送一条消息（或从群聊中），并在回调消息结构中找到对应的wxid。

例如：您可以调用Gewe API的搜索好友接口来搜索您想要查找的机器人朋友的wxid，调用Gewe API的获取通讯录列表接口列出您所有的联系人信息，从中找到您想要检索的朋友或群聊的wxid。

⚙️ 环境变量

变量名称必需描述
GEWE_NOTICE_BASE_URL NoGewe API基础地址，默认https://www.geweapi.com
GEWE_NOTICE_TOKEN ✅ Gewe API Token (UUID)
GEWE_NOTICE_APP_ID ✅ 微信机器人App ID，必须以wx_开头
GEWE_NOTICE_WXID✅接收者WXID；对于群聊，使用@chatroom结尾
GEWE_NOTICE_AT_LIST No逗号分隔的WXID列表或all，用于指定@成员或所有人

命令验证（二进制方法）

GEWE_NOTICE_TOKEN=... \
GEWE_NOTICE_APP_ID=wx_xxx \
GEWE_NOTICE_WXID=wxid_xxx \
./gewe-notice-mcp

# 使用 npx 快速验证
GEWE_NOTICE_TOKEN=... \
GEWE_NOTICE_APP_ID=wx_xxx \
GEWE_NOTICE_WXID=wxid_xxx \
npx -y gewe-notice-mcp

🛠️ MCP工具：post_text

此MCP服务器提供了一个名为post_text的工具，用于发送通知。

参数

  • content 要发送的通知文本内容

推荐的消息格式

为了保持通知的一致性，建议使用以下格式：

[状态表情] [模块/主题] - [具体消息]

示例：

  • ✅ 成功 ✅ [项目初始化] - 项目初始化成功，所有依赖已安装
  • --- 失败 ❌ [API调用] - 任务失败，请检查API密钥或网络连接
  • ⚠️ 警告 ⚠️ [构建] - 构建完成但有警告信息
  • 📊 进度 📊 [数据分析] - 数据分析完成50%

您还可以在代理规则中自定义通知格式。

🖥️ MCP客户端配置指南

配置示例

<details> <summary>点击展开查看四种不同场景的配置示例</summary>

1. 发送到个人

"gewe-notice": {
  "command": "/path/to/gewe-notice-mcp",
  "args": [],
  "env": {
    "GEWE_NOTICE_TOKEN": "YOUR_GEWE_TOKEN",
    "GEWE_NOTICE_APP_ID": "YOUR_BOT_APP_ID",
    "GEWE_NOTICE_WXID": "wxid_xxxxxxxxxxxxx"
  }
}

2. 发送到群聊（不标记任何人）

"gewe-notice": {
  "command": "/path/to/gewe-notice-mcp",
  "args": [],
  "env": {
    "GEWE_NOTICE_TOKEN": "YOUR_GEWE_TOKEN",
    "GEWE_NOTICE_APP_ID": "YOUR_BOT_APP_ID",
    "GEWE_NOTICE_WXID": "xxxxxxxxxx@chatroom"
  }
}

3. 发送到群聊并@所有人

"gewe-notice": {
  "command": "/path/to/gewe-notice-mcp",
  "args": [],
  "env": {
    "GEWE_NOTICE_TOKEN": "YOUR_GEWE_TOKEN",
    "GEWE_NOTICE_APP_ID": "YOUR_BOT_APP_ID",
    "GEWE_NOTICE_WXID": "xxxxxxxxxx@chatroom",
    "GEWE_NOTICE_AT_LIST": "all"
  }
}

4. 发送到群聊并@特定成员

环境变量GEWE_NOTICE_AT_LIST接受用逗号分隔的wxid字符串。

"gewe-notice": {
  "command": "/path/to/gewe-notice-mcp",
  "args": [],
  "env": {
    "GEWE_NOTICE_TOKEN": "YOUR_GEWE_TOKEN",
    "GEWE_NOTICE_APP_ID": "YOUR_BOT_APP_ID",
    "GEWE_NOTICE_WXID": "xxxxxxxxxx@chatroom",
    "GEWE_NOTICE_AT_LIST": "wxid_aaaaaaaa,wxid_bbbbbbbb"
  }
}

注意：对于二进制方法，使用/path/to/gewe-notice-mcp指向实际的二进制文件路径。对于npx方法，将command改为"npx"，args改为["-y", "gewe-notice-mcp"]。

</details>

配置完成后，您的AI IDE或AI CLI将在启动时自动运行gewe-notice服务器。

各客户端的具体配置

以下示例提供了“本地二进制”（推荐）和“npx兼容”两种格式。请将App ID、Token、WXID等替换为真实值。

<details> <summary><b>Cursor</b></summary>

本地二进制

{
  "mcpServers": {
    "gewe-notice": {
      "command": "/path/to/gewe-notice-mcp",
      "args": [],
      "env": {
        "GEWE_NOTICE_BASE_URL": "https://www.geweapi.com",
        "GEWE_NOTICE_TOKEN": "YOUR_TOKEN",
        "GEWE_NOTICE_APP_ID": "wx_xxx",
        "GEWE_NOTICE_WXID": "wxid_xxx"
      }
    }
  }
}

npx兼容

{
  "mcpServers": {
    "gewe-notice": {
      "command": "npx",
      "args": ["-y", "gewe-notice-mcp"],
      "env": {
        "GEWE_NOTICE_BASE_URL": "https://www.geweapi.com",
        "GEWE_NOTICE_TOKEN": "YOUR_TOKEN",
        "GEWE_NOTICE_APP_ID": "wx_xxx",
        "GEWE_NOTICE_WXID": "wxid_xxx"
      }
    }
  }
}
</details> <details> <summary><b>Codex（OpenAI桌面客户端）</b></summary>

本地二进制

[mcp_servers.gewe_notice]
command = "/path/to/gewe-notice-mcp"
env = {
  GEWE_NOTICE_BASE_URL = "https://www.geweapi.com",
  GEWE_NOTICE_TOKEN = "YOUR_TOKEN",
  GEWE_NOTICE_APP_ID = "wx_xxx",
  GEWE_NOTICE_WXID = "wxid_xxx"
}

npx兼容

[mcp_servers.gewe_notice]
command = "npx"
args = ["-y", "gewe-notice-mcp"]
env = {
  GEWE_NOTICE_BASE_URL = "https://www.geweapi.com",
  GEWE_NOTICE_TOKEN = "YOUR_TOKEN",
  GEWE_NOTICE_APP_ID = "wx_xxx",
  GEWE_NOTICE_WXID = "wxid_xxx"
}

Windows注意事项

如果在Windows上遇到请求超时问题，进程无法启动。您可以明确指定Node路径或通过cmd间接调用：

[mcp_servers.gewe_notice]
command = "C:\\Program Files\\nodejs\\node.exe"
args = [
  "C:\\Users\\yourname\\AppData\\Roaming\\npm\\node_modules\\gewe-notice-mcp\\dist\\index.js",
  "--transport",
  "stdio"
]

或者：

[mcp_servers.gewe_notice]
command = "cmd"
args = [
  "/c",
  "npx",
  "-y",
  "gewe-notice-mcp"
]
env = { SystemRoot = "C:\\Windows" }
startup_timeout_ms = 20_000

上述配置可以提高Codex CLI在Windows上的稳定性。

</details> <details> <summary><b>Claude Code CLI</b></summary>

本地二进制

claude mcp add gewe-notice -- /path/to/gewe-notice-mcp \
  --env GEWE_NOTICE_BASE_URL=https://www.geweapi.com \
  --env GEWE_NOTICE_TOKEN=YOUR_TOKEN \
  --env GEWE_NOTICE_APP_ID=wx_xxx \
  --env GEWE_NOTICE_WXID=wxid_xxx

npx兼容

claude mcp add gewe-notice -- npx -y gewe-notice-mcp \
  --env GEWE_NOTICE_BASE_URL=https://www.geweapi.com \
  --env GEWE_NOTICE_TOKEN=YOUT_TOKEN \
  --env GEWE_NOTICE_APP_ID=wx_xxx \
  --env GEWE_NOTICE_WXID=wxid_xxx

完成后运行claude mcp list验证是否注册成功。

</details> <details> <summary><b>VS Code / GitHub Copilot Chat</b></summary>

本地二进制

"mcp": {
  "servers": {
    "gewe-notice": {
      "type": "stdio",
      "command": "/path/to/gewe