Infomaniak MCP

🚀 Infomaniak MCP Server

このサーバーは、Model Context Protocol (MCP) を使用して Infomaniak API とやり取りするためのものです。Claude などのAIアシスタントが、ドメイン、メール、ウェブホスティング、kDrive などの Infomaniak サービスを管理できるようになります。

✨ 主な機能

• 🌐 ドメイン管理 - ドメインの一覧表示、DNSレコードの完全なCRUD操作
• 📧 メールサービス - メールボックス、エイリアス、メール設定の管理
• 🖥️ ウェブホスティング - サイト、PHPバージョン、MySQLデータベースの管理
• 💾 kDrive - kDriveクラウドストレージのアクセスと管理
• 🔒 Swiss Backup - バックアップ製品の表示と管理
• 🖧 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トランスポートをサポートしており、ウェブベースの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

ウェブクライアントからの接続

// ステップ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
  })
});

🛠️ 利用可能なツール

アカウントとプロフィール

ドメイン管理

メールサービス

ウェブホスティング

クラウドストレージ

インフラストラクチャ

証明書と請求書

高度な機能

💻 使用例

すべてのアカウントを一覧表示

"List all my Infomaniak accounts"

DNSレコードの管理

"Add an A record for www.example.com pointing to 192.168.1.100"
"Show all DNS records for mydomain.ch"
"Delete the TXT record with ID 12345 from example.com"

メールボックスの作成

"Create a new email address info@mydomain.com with password SecurePass123"

インフラストラクチャの確認

"Show me the status of all my VPS instances"
"Reboot my VPS with ID 456"

カスタムAPI呼び出し

"Make a GET request to /1/account to see all account details"

🔧 開発

セットアップ

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には1分間に60回のリクエストのレート制限があります。自動化を使用する際は、リクエスト頻度に注意してください。

🐛 トラブルシューティング

"INFOMANIAK_API_TOKEN environment variable is required"

MCPクライアントの設定で INFOMANIAK_API_TOKEN が設定されていることを確認してください。

"Infomaniak API Error (401)"

APIトークンが無効または期限切れの可能性があります。Infomaniakマネージャーから新しいトークンを生成してください。

"Infomaniak API Error (403)"

トークンに必要なスコープがない可能性があります。適切な権限を持つ新しいトークンを作成してください。

"Infomaniak API Error (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の始め方
• Model Context Protocol
• MCP TypeScript SDK

🙏 謝辞

• Infomaniak の包括的なAPI
• Anthropic のModel Context Protocol
• オープンソースコミュニティ

Made with ❤️ for the Infomaniak and MCP community