mcp-sms-ir

🚀 SMS.ir MCP 服务器

这是一个用于 SMS.ir 消息服务的 Model Context Protocol (MCP) 服务器。它能让像 Claude 这样的 AI 助手，借助 SMS.ir API 来发送 SMS 短信，为消息通信提供了便捷的解决方案。

✨ 主要特性

• 可单独向单个收件人发送 SMS 短信。
• 支持向多个收件人批量发送 SMS 短信。
• 能使用模板发送验证代码 SMS。
• 可以检查账户余额。

📦 安装指南

先决条件

• 需要 Node.js v18 或更高版本。
• 要有 SMS.ir 的一个 API 密钥。

安装方法

方法 1: 从 npm 安装（推荐）

你可以直接通过 npx 从 npm 进行安装：

# 不需要安装；npx 可以按需运行

此方法更受推荐，因为它让你无需手动下载即可使用服务器，而且更新也很方便。

方法 2: 手动安装

如果你更倾向于手动安装并自定义服务器，可以按以下步骤操作：

1. 克隆此仓库：

git clone https://github.com/your-username/mcp-sms-ir.git
cd mcp-sms-ir

2. 安装依赖项：

bun install
# 或
npm install

3. 构建项目：

npm run build

4. 启动服务器：

npm start

📚 详细文档

请访问 官方文档 了解详细信息。

💻 使用示例

基础用法

发送 SMS 短信

在终端中运行以下命令：

npx mcp-sms-ir send_sms --mobile=09121234567 --message="Hello from Claude"

批量发送 SMS 短信

在终端中运行以下命令：

npx mcp-sms-ir send_bulk_sms --mobiles=09121234567,09123456789 --messageText="Hello from Claude"

发送验证代码

在终端中运行以下命令：

npx mcp-sms-ir send_verification_code --mobile=09121234567 --templateId=100000 --parameters='[{"name":"CODE","value":"123456"}]'

检查账户余额

在终端中运行以下命令：

npx mcp-sms-ir check_credit

📄 许可证

本项目采用 MIT 许可证。

致谢

• SMS.ir 为提供消息 API。
• Model Context Protocol 实现此集成。