Clicksend MCP Server

🚀 ClickSend MCP 服務器

ClickSend MCP 服務器是一個模型上下文協議（MCP）服務器，它允許 Claude 和其他 AI 助手通過 ClickSend 發送短信和彩信，為信息發送提供了便捷的解決方案。

🚀 快速開始

使用此服務器前，需要滿足一定的要求並進行相關配置，以下為您詳細介紹。

✨ 主要特性

• 只需設置 ClickSend 用戶名和 API 密鑰，即可一次性發送短信。

📦 安裝指南

環境要求

• Node.js >= 18
  • 您可以使用nvm（Node 版本管理器）來設置正確的版本以運行此應用程序。

環境變量配置

該服務器需要兩個環境變量：

• CLICKSEND_USERNAME: 您的 ClickSend 用戶名
• CLICKSEND_API_KEY: 您的 ClickSend API 密鑰

您可以在ClickSend 控制面板找到用戶名和密鑰，前提是您已註冊 ClickSend。

Claude Desktop 配置

要將此服務器與 Claude Desktop 一起使用，請在配置文件中添加以下內容：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "clicksend": {
      "command": "node",
      "args": [
        "-y",
        "@clicksend/sms-mcp-server"
      ],
      "env": {
        "CLICKSEND_USERNAME": "您的ClickSend用戶名",
        "CLICKSEND_API_KEY": "您的API密鑰",
      }
    }
  }
}

設置完成後，重啟 Claude Desktop 以重新加載配置。如果已連接，則在點擊錘子圖標時應顯示“clicksend - send - sms”。

💻 使用示例

基礎用法

以下是通過 Claude 與服務器互動的自然方式，以發送簡單短信為例：

向號碼61411111111發送一條消息：“我正在使用ClickSend MCP服務器發送短信！”

📚 詳細文檔

重要說明

⚠️ 重要提示

1. 電話號碼格式：所有電話號碼必須採用 E.164 格式（例如，+61411111111）
2. 速率限制：注意您的 ClickSend 賬戶的速率限制和定價
3. 安全：保持 ClickSend 憑證的安全性，切勿將其提交到版本控制系統

常見問題

常見錯誤消息及解決方案：

1. “電話號碼必須採用 E.164 格式”
   • 確保電話號碼以“+”開頭，幷包含國家代碼。
2. “無效憑證”
   • 檢查CLICKSEND_USERNAME和CLICKSEND_API_KEY。您可以在ClickSend 儀表盤複製它們。

貢獻

歡迎貢獻！請在提交拉取請求之前閱讀我們的貢獻指南。

安全

⚠️ 重要提示

請勿在 GitHub 問題或拉取請求中包含任何敏感信息（如電話號碼或 ClickSend 憑證）。

📄 許可證

本項目根據 MIT 許可證發佈，詳細信息請參閱 LICENSE 文件。