SMS.ir MCP 服务器

这是一个用于 SMS.ir 消息服务的模型上下文协议 (MCP) 服务器。它允许像 Claude 这样的人工智能助手通过 SMS.ir API 发送 SMS 消息。

功能

• 向单个收件人发送单条 SMS 消息
• 向多个收件人发送批量 SMS 消息
• 使用模板发送验证码 SMS 消息
• 检查帐户信用余额

安装

前提条件

• Node.js v18 或更高版本
• 来自 SMS.ir 的 API 密钥

安装方法

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

您可以使用 npx 直接从 npm 安装 MCP 服务器：

# 无需安装；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 link

配置

从 SMS.ir 获取 API 密钥

1. 如果您还没有帐户，请在 SMS.ir 上创建一个帐户
2. 登录到您的帐户
3. 转到您的用户面板
4. 找到 API 密钥部分并生成/复制您的 API 密钥

在 Cline VSCode 扩展中配置 MCP 服务器

将 SMS.ir 服务器添加到您的 Cline MCP 设置文件中：

使用 npx（推荐）

{
  "mcpServers": {
    "sms-ir": {
      "command": "npx",
      "args": ["-y", "mcp-sms-ir"],
      "env": {
        "SMS_IR_API_KEY": "your-api-key-from-sms-ir"
      }
    }
  }
}

使用本地安装

{
  "mcpServers": {
    "sms-ir": {
      "command": "node",
      "args": ["/path/to/mcp-sms-ir/build/index.js"],
      "env": {
        "SMS_IR_API_KEY": "your-api-key-from-sms-ir"
      }
    }
  }
}

将 /path/to/mcp-sms-ir 替换为您系统上此存储库的实际路径，并将 your-api-key-from-sms-ir 替换为您的 SMS.ir 的实际 API 密钥。

在 Claude 桌面应用程序中配置 MCP 服务器

将 SMS.ir 服务器添加到您的 Claude 桌面应用程序配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

使用 npx（推荐）

{
  "mcpServers": {
    "sms-ir": {
      "command": "npx",
      "args": ["-y", "mcp-sms-ir"],
      "env": {
        "SMS_IR_API_KEY": "your-api-key-from-sms-ir"
      }
    }
  }
}

使用本地安装

{
  "mcpServers": {
    "sms-ir": {
      "command": "node",
      "args": ["/path/to/mcp-sms-ir/build/index.js"],
      "env": {
        "SMS_IR_API_KEY": "your-api-key-from-sms-ir"
      }
    }
  }
}

发布到 npm

要使此软件包可以通过 npx 使用，您需要将其发布到 npm。方法如下：

1. 确保您拥有一个 npm 帐户。如果没有，请在 npmjs.com 上创建一个。

2. 从您的终端登录到 npm：

   npm login
   

3. 使用您的信息更新 package.json 文件：

   • 将您的姓名设置为作者
   • 更新存储库 URL 以指向您的 GitHub 存储库
   • 确保软件包名称是唯一的（在 npmjs.com 上检查）

4. 准备您的软件包以进行发布：

   npm run build
   

5. 发布软件包：

   npm publish
   

   如果这是您第一次发布此软件包，请使用：

   npm publish --access=public
   

6. 发布后，任何人都可以通过使用 npx 将其添加到他们的 MCP 设置中来使用您的 MCP 服务器，如上面的配置部分所示。

可用工具

1. send_sms - 发送单条 SMS

向单个收件人发送 SMS 消息。

参数：

• mobile（必需）：收件人手机号码（例如，“09121234567”）
• message（必需）：消息内容
• lineNumber（可选）：发件人线路号码
• sendDateTime（可选）：发送消息的计划日期和时间（ISO 格式）

示例：

{
  "mobile": "09121234567",
  "message": "Hello from SMS.ir MCP!",
  "lineNumber": "3000xxxx"
}

2. send_bulk_sms - 发送批量 SMS

将相同的 SMS 消息发送给多个收件人。

参数：

• mobiles（必需）：收件人手机号码数组
• messageText（必需）：要发送给所有收件人的消息内容
• lineNumber（可选）：发件人线路号码
• sendDateTime（可选）：发送消息的计划日期和时间（ISO 格式）

示例：

{
  "mobiles": ["09121234567", "09123456789"],
  "messageText": "Hello from SMS.ir MCP!",
  "lineNumber": "3000xxxx"
}

3. send_verification_code - 发送验证码

使用模板发送验证码 SMS。

参数：

• mobile（必需）：收件人手机号码
• templateId（必需）：来自 SMS.ir 面板的模板 ID
• parameters（必需）：要在模板中替换的参数数组

示例：

{
  "mobile": "09121234567",
  "templateId": "100000",
  "parameters": [
    {
      "name": "CODE",
      "value": "123456"
    }
  ]
}

4. check_credit - 检查帐户信用

检查您的 SMS.ir 帐户中剩余的信用额度。

参数： 无

与 Claude 的使用示例

正确配置 MCP 服务器后，您可以要求 Claude 使用它：

发送单条 SMS

您：“你能发送一条 SMS 给 09121234567 说 ‘Hello from Claude’ 吗？”

Claude 将使用 send_sms 工具发送消息。

发送验证码

您：“使用模板 ID 100000 和代码 123456 向 09121234567 发送验证码”

Claude 将使用带有模板和参数的 send_verification_code 工具。

检查帐户信用

您：“检查我的 SMS.ir 帐户信用余额”

Claude 将使用 check_credit 工具检索并报告您当前的余额。

许可证

MIT

鸣谢

• SMS.ir 提供消息传递 API
• 模型上下文协议 启用此集成