消息通知-MCP服务器
项目介绍
MNotify MCP Server
通过一条命令将MNotify集成到您的AI IDE中。
此包将MNotify短信API作为MCP服务器公开，因此工具如Cursor可以通过stdio安全地调用真实的MNotify操作（发送短信、管理联系人/群组/模板、投递报告）。该仓库还包括一个简单的交互式MNotify代理用于CLI使用。它基于Mnotify API v2.0。
在这里查看PyPI MCP包
要求
- Python 3.10+
- 环境变量：
MNOTIFY_API_KEY
安装
- 使用uv（推荐）：
curl -LsSf https://astral.sh/uv/install.sh | sh # 如果需要，请安装uv uv venv uv pip install -r requirements.txt - 使用任何虚拟环境管理器+pip：
python -m venv .venv && source .venv/bin/activate pip install -r requirements.txt
快速开始 — 安装并运行MCP服务器
pip install mnotify_mcp_server
export MNOTIFY_API_KEY=sk_mnotify_...
# 启动服务器（推荐）
mnotify_mcp server
# 其他选项
mnotify-mcp
python -m mnotify_mcp.server
连接到Cursor
- 选项A：项目配置
.cursor/mcp.json（推荐）
{
"mcpServers": {
"mnotify": {
"command": "mnotify_mcp",
"args": ["server"]
}
}
}
从与虚拟环境相同的环境中重新启动cursor
- 选项B：手动添加到Cursor（设置 → MCP → 添加自定义服务器 → 进程）
- 命令：
mnotify_mcp - 参数：
server - 确保在Cursor启动进程的环境中设置了
MNOTIFY_API_KEY
- 命令：
MNotify代理（交互式CLI）
一个本地聊天代理，可以直接调用所有MNotify工具。
安装
- 创建一个虚拟环境，并使用uv或pip安装依赖项（参见上文）。
- 添加一个
.env文件，内容如下：
OPENROUTER_API_KEY=sk-or-v1-...
MNOTIFY_API_KEY=...
AGNO_API_KEY=ag-... # 可选，如果设置了监控。
启动代理
uv run mnotify_agent.py
CLI命令
- help: 列出命令
- history: 显示最近的消息
- tools: 列出可用工具
- test: 运行快速工具调用测试
- clear: 清除对话上下文
暴露的工具
- 短信：
send_quick_bulk_sms,send_bulk_group_sms,update_scheduled_sms - 报告：
sms_delivery_report,specific_sms_delivery_report,periodic_sms_delivery_report - 联系人：
add_contact,update_contact,delete_contact,get_contact_details,get_contact_list,get_group_contacts - 群组：
add_group,update_group,delete_group,get_group_details,get_group_list - 模板：
get_template_list,get_message_template,add_message_template,update_message_template,delete_message_template - 实用工具：
register_sender_id,check_sender_id,check_sms_balance - 辅助工具：
get_context_snapshot,resolve_group_name
验证与防护措施
message长度≤460；sender_id长度≤11。schedule=true需要schedule_time（YYYY-MM-DD HH:MM）。- 可选：
verify_sender=true在发送前执行最佳努力的发送者状态检查。
安全性
- 不要将密钥作为工具参数传递。服务器从环境读取
MNOTIFY_API_KEY。 - 服务器不会记录密钥。