infomaniak MCP

Infomaniak MCP服务器

](https://www.npmjs.com/package/infomaniak-mcp-server)  

A. 模型上下文协议（MCP） 用于与交互的服务器 API信息该服务器使像Claude这样的人工智能助手能够管理Infomaniak服务，包括域名、电子邮件、网络托管、kDrive等。

✨ 特性

• 🌐 域管理 -列出域名，完整DNS记录CRUD操作
• 📧 电子邮件服务 -管理邮箱、别名和邮件配置
• 🖥️ 网站托管 -管理网站、PHP版本和MySQL数据库
• 💾 k驱动 -访问和管理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 -k驱动器访问 - swiss_backup -备份服务 - vps -VPS管理 - dedicated -专用服务器 - certificate -SSL证书 - invoicing -计费访问

1. 复制并安全存储您的令牌

📦 安装

使用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配置文件中：

{
  "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模式启动

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

# From source
MCP_TRANSPORT=http MCP_PORT=3000 INFOMANIAK_API_TOKEN=your-token node build/index.js

HTTP端点

会话模式

• 有状态的 （默认）：跨请求维护会话状态。每个客户端在 Mcp-Session-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"]

# Build and run
docker build -t infomaniak-mcp .
docker run -p 3000:3000 -e INFOMANIAK_API_TOKEN=your-token infomaniak-mcp

从Web客户端连接

// Step 1: Initialize session
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');

// Step 2: Use session for subsequent requests
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的费率限制为 每分钟60个请求使用自动化时，请注意请求频率。

🐛 故障排除

“需要INFOMANIAK_API_TOKEN环境变量”

确保您已设置 INFOMANIAK_API_TOKEN 在您的MCP客户端配置中。

“Infomaniak API错误（401）”

您的API令牌可能无效或已过期。从Infomaniak Manager生成新令牌。

“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许可证获得许可-请参阅 许可证 文件以获取详细信息。

🔗 资源

• Infomaniak API文档
• Infomaniak入门指南
• 模型上下文协议
• MCP TypeScript SDK

🙏 致谢

• 信息手册 为其全面的API
• Anthropic 对于模型上下文协议
• 开源社区

______________________________________________________________________

Made with ❤️ for the Infomaniak and MCP community