Infomaniak MCP

🚀 Infomaniak MCP 服務器

這是一個用於與 Infomaniak API 交互的 模型上下文協議 (MCP) 服務器。該服務器使 Claude 等 AI 助手能夠管理 Infomaniak 的各項服務，包括域名、電子郵件、網站託管、kDrive 等。

🚀 快速開始

要使用 Infomaniak MCP 服務器，你需要完成以下幾個步驟：

1. 確保滿足前置條件，包括安裝 Node.js 18 或更高版本，擁有 Infomaniak 賬戶並獲取 API 令牌。
2. 按照安裝指南進行安裝，可以選擇使用 npm 安裝或從源代碼安裝。
3. 進行配置，根據不同的使用場景（如 Claude Desktop）設置相應的配置文件和環境變量。
4. 選擇合適的傳輸模式（如 HTTP 傳輸）並啟動服務器。

✨ 主要特性

• 🌐 域名管理 - 列出域名，進行完整的 DNS 記錄增刪改查操作。
• 📧 電子郵件服務 - 管理郵箱、別名和郵件配置。
• 🖥️ 網站託管 - 管理網站、PHP 版本和 MySQL 數據庫。
• 💾 kDrive - 訪問和管理 kDrive 雲存儲。
• 🔒 瑞士備份 - 查看和管理備份產品。
• 🖧 VPS 與服務器 - 控制 VPS 實例和專用服務器。
• 📜 SSL 證書 - 查看證書信息。
• 💰 發票管理 - 訪問賬單和發票數據。
• 🔧 通用 API - 進行自定義 API 調用以執行高級操作。

📋 前置條件

• Node.js 18 或更高版本。
• 具有 API 訪問權限的 Infomaniak 賬戶。
• 從 Infomaniak 獲取的 API 令牌。

🔑 獲取 API 令牌

1. 登錄你的 Infomaniak 管理器。
2. 導航到 賬戶 → API 令牌 或訪問 令牌管理。
3. 點擊 "創建令牌"。
4. 根據你的需求選擇適當的作用域：
   • account - 賬戶管理
   • domain - 域名管理
   • mail - 電子郵件服務
   • web - 網站託管
   • drive - kDrive 訪問
   • swiss_backup - 備份服務
   • vps - VPS 管理
   • dedicated - 專用服務器
   • certificate - SSL 證書
   • invoicing - 賬單訪問
5. 複製並安全存儲你的令牌。

📦 安裝指南

使用 npm（推薦）

npm install -g infomaniak-mcp-server

從源代碼安裝

git clone https://github.com/YOUR_USERNAME/infomaniak-mcp-server.git
cd infomaniak-mcp-server
npm install
npm run build

⚙️ 配置

Claude Desktop

將以下內容添加到你的 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "infomaniak": {
      "command": "npx",
      "args": ["-y", "infomaniak-mcp-server"],
      "env": {
        "INFOMANIAK_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

或者，如果是全局安裝或從源代碼安裝：

{
  "mcpServers": {
    "infomaniak": {
      "command": "node",
      "args": ["/path/to/infomaniak-mcp-server/build/index.js"],
      "env": {
        "INFOMANIAK_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

環境變量

🌐 HTTP 傳輸

服務器支持帶有 SSE 流的 HTTP 傳輸，允許基於 Web 的 MCP 客戶端和遠程連接。

以 HTTP 模式啟動

# 使用 npx
MCP_TRANSPORT=http MCP_PORT=3000 INFOMANIAK_API_TOKEN=your-token npx infomaniak-mcp-server

# 從源代碼啟動
MCP_TRANSPORT=http MCP_PORT=3000 INFOMANIAK_API_TOKEN=your-token node build/index.js

HTTP 端點

會話模式

• 有狀態（默認）：在請求之間保持會話狀態。每個客戶端在初始化後會在 Mcp-Session-Id 標頭中獲得一個唯一的會話 ID。
• 無狀態：每個請求都是獨立的。對於無服務器部署，設置 MCP_STATELESS=true。

Docker 部署

FROM node:20-alpine
WORKDIR /app
RUN npm install -g infomaniak-mcp-server
ENV MCP_TRANSPORT=http
ENV MCP_PORT=3000
EXPOSE 3000
CMD ["infomaniak-mcp-server"]

# 構建並運行
docker build -t infomaniak-mcp .
docker run -p 3000:3000 -e INFOMANIAK_API_TOKEN=your-token infomaniak-mcp

從 Web 客戶端連接

// 步驟 1: 初始化會話
const initResponse = await fetch('http://localhost:3000/mcp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json, text/event-stream'
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'initialize',
    params: { protocolVersion: '2025-03-26', capabilities: {}, clientInfo: { name: 'my-client', version: '1.0.0' } },
    id: 1
  })
});
const sessionId = initResponse.headers.get('Mcp-Session-Id');

// 步驟 2: 使用會話進行後續請求
const response = await fetch('http://localhost:3000/mcp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json, text/event-stream',
    'Mcp-Session-Id': sessionId
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'tools/list',
    id: 2
  })
});

🛠️ 可用工具

賬戶與個人資料

域名管理

電子郵件服務

網站託管

雲存儲

基礎設施

證書與賬單

高級功能

💻 使用示例

列出所有賬戶

"列出我所有的 Infomaniak 賬戶"

管理 DNS 記錄

"為 www.example.com 添加一個指向 192.168.1.100 的 A 記錄"
"顯示 mydomain.ch 的所有 DNS 記錄"
"從 example.com 刪除 ID 為 12345 的 TXT 記錄"

創建郵箱

"創建一個新的電子郵件地址 info@mydomain.com，密碼為 SecurePass123"

檢查基礎設施

"顯示我所有 VPS 實例的狀態"
"重啟 ID 為 456 的 VPS"

自定義 API 調用

"對 /1/account 進行 GET 請求以查看所有賬戶詳細信息"

🔧 開發

環境搭建

git clone https://github.com/YOUR_USERNAME/infomaniak-mcp-server.git
cd infomaniak-mcp-server
npm install

構建項目

npm run build

監聽模式

npm run dev

使用 MCP 檢查器進行測試

INFOMANIAK_API_TOKEN=your-token npm run inspector

⚠️ API 速率限制

Infomaniak API 的速率限制為 每分鐘 60 個請求。在使用自動化操作時，請注意請求頻率。

🐛 故障排除

"INFOMANIAK_API_TOKEN 環境變量是必需的"

確保你已在 MCP 客戶端配置中設置了 INFOMANIAK_API_TOKEN。

"Infomaniak API 錯誤 (401)"

你的 API 令牌可能無效或已過期。從 Infomaniak 管理器生成一個新的令牌。

"Infomaniak API 錯誤 (403)"

你的令牌沒有所需的作用域。創建一個具有適當權限的新令牌。

"Infomaniak API 錯誤 (429)"

速率限制已超出。等待一段時間後再進行更多請求。

🤝 貢獻

歡迎貢獻代碼！請閱讀我們的 貢獻指南 以獲取詳細信息。

1. 分叉倉庫。
2. 創建你的功能分支 (git checkout -b feature/amazing-feature)。
3. 提交你的更改 (git commit -m 'feat: add amazing feature')。
4. 推送到分支 (git push origin feature/amazing-feature)。
5. 打開一個拉取請求。

📄 許可證

本項目採用 MIT 許可證 - 有關詳細信息，請參閱 LICENSE 文件。

🔗 資源

• Infomaniak API 文檔
• Infomaniak 入門指南
• 模型上下文協議
• MCP TypeScript SDK

🙏 致謝

• Infomaniak 提供的全面 API。
• Anthropic 開發的模型上下文協議。
• 開源社區。

為 Infomaniak 和 MCP 社區用心打造 ❤️