DoiT MCP 服务器

DoiT MCP 服务器提供对 DoiT API 的访问。此服务器使像 Claude 这样的 LLM 能够访问 DoiT 平台数据，用于故障排除和分析。

要求

• Node.js v18 或更高版本
• 具有适当权限的 DoiT API 密钥
• 客户上下文标识符（用于特定于客户的数据）

安装

要获取您的 DoiT API 密钥，请访问您 DoiT 个人资料中的 API 密钥部分。

有几种方法可以安装和配置 MCP 服务器：

通过 Smithery 安装（推荐）

要通过 Smithery 为 Claude Desktop 自动安装 doit-mcp-server：

npx -y @smithery/cli install @doitintl/doit-mcp-server --client claude

Claude Desktop App

要为 Claude Desktop App 手动配置 MCP 服务器，请将以下内容添加到您的 claude_desktop_config.json 文件中，或通过“设置”进行配置，如此处所述：

{
  "mcpServers": {
    "doit_mcp_server": {
      "command": "npx",
      "args": ["-y", "@doitintl/doit-mcp-server@latest"],
      "env": {
        "DOIT_API_KEY": "your_doit_api_key"
      }
    }
  }
}

请确保将环境变量替换为您的实际值：

• DOIT_API_KEY: 您的 DoiT API 密钥，具有适当的权限
• CUSTOMER_CONTEXT: 您的客户上下文标识符（可选）

注意：您需要在更新配置后重启 Claude for Desktop才能使更改生效。

Cursor

对于 Cursor IDE，您可以使用 Smithery 安装此 MCP 服务器（推荐）：

npx -y @smithery/cli install @doitintl/doit-mcp-server --client cursor

或者使用以下命令在您的项目中手动安装：

env DOIT_API_KEY=[KEY] npx -y @doitintl/doit-mcp-server@latest

不要忘记将该命令中的 env 值替换为您的实际值。

如果您有最新版本（v0.47 及以上）的 Cursor，您可以在项目根目录中创建一个 mcp.json 文件：

{
  "mcpServers": {
    "DoiT": {
      "command": "npx",
      "args": [
        "DOIT_API_KEY=your_doit_api_key",
        "--",
        "npx",
        "-y",
        "@doitintl/doit-mcp-server@latest"
      ]
    }
  }
}

克隆到本地仓库

如果您想直接从源代码克隆和运行此 MCP 服务器，请按照以下步骤操作：

1. 克隆仓库

git clone https://github.com/doitintl/doit-mcp-server
cd doit-mcp-server

2. 安装依赖

yarn install

3. 构建项目

yarn build

5. 运行服务器

node dist/index.js

工具

此 MCP 服务器提供以下工具：

• get_cloud_incidents: 从各种平台检索云事件
• get_cloud_incident: 按 ID 获取有关特定云事件的详细信息
• get_anomalies: 检索在云资源中检测到的异常
• get_anomaly: 按 ID 获取有关特定异常的详细信息
• list_reports: 列出您的帐户有权访问的 Cloud Analytics 报告
• run_query: 使用指定的配置运行报告查询，而不持久化它
• get_report_results: 按 ID 获取特定报告的结果
• validate_user: 验证当前 API 用户并返回域和电子邮件信息
• list_dimensions: 列出您的帐户有权访问的 Cloud Analytics 维度
• get_dimension: 按类型和 ID 获取特定的 Cloud Analytics 维度

使用示例

以下是您可以使用 DoiT MCP 服务器提出的一些常见查询：

成本分析和节省

• "我的 Flexsave 节省是多少？" - 这将分析您在云帐户中的 Flexsave 成本优化节省。
• "按成本计算，我的前 3 个 AWS 服务是什么？" - 这将运行 Cloud Analytics 查询以识别您支出最高的 AWS 服务。

报告和分析

• "列出我所有可用的报告" - 这将显示您有权访问的所有 Cloud Analytics 报告。
• "向我展示我的“每月成本概览”报告的结果" - 这将获取并显示特定报告的结果。

异常检测

• "我最近的 GCP 异常是什么？" - 这将显示在您的 Google Cloud Platform 帐户中检测到的最近的成本或使用异常。
• "向我展示关于异常 ABC123 的详细信息" - 这将提供关于特定异常的详细信息。

这些示例演示了基本的使用模式。您可以根据您的需要组合和修改这些查询。 MCP 服务器将解释您的自然语言查询，并使用适当的工具来获取所请求的信息。

环境变量

• DOIT_API_KEY: 您的 DoiT API 密钥（必需）
• CUSTOMER_CONTEXT: 您的客户上下文标识符（可选）