# @doitintl/doit-mcp-server 中文文档

规范地址：https://npmcn.com/package/%40doitintl/doit-mcp-server/

版本：4\.0\.0
npm 元数据更新时间：2026-11-12T12:37:52.681Z
中文译文更新时间：2026-11-12T14:55:54.115Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40doitintl/doit-mcp-server
原文对照：https://npmcn.com/package/%40doitintl/doit-mcp-server/?lang=original
项目主页：https://github.com/doitintl/doit-mcp-server#readme
源码仓库：https://github.com/doitintl/doit-mcp-server

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：11.8 MB，317 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：3 个
- 首次发布：2025-05-15T11:07:29.895Z
- 最新版本发布：2026-11-12T12:37:52.222Z
- 近 30 天下载量：12985（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：79（近 12 个月 64 个）

## 中文简介

DoiT 官方 MCP 服务器

## 安装

```sh
npm install @doitintl/doit-mcp-server
```

也可以使用：`pnpm add @doitintl/doit-mcp-server`、`yarn add @doitintl/doit-mcp-server`、`bun add @doitintl/doit-mcp-server`

## README

# DoiT MCP 服务器

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ![NPM Version](https://img.shields.io/npm/v/%40doitintl%2Fdoit-mcp-server?registry_uri=https%3A%2F%2Fregistry.npmjs.com%2F%40doitintl%2Fdoit-mcp-server)

DoiT MCP 软件 服务器提供访问DoiT API的功能. 这个服务器可以让克洛德这样的LLMs访问多伊T平台数据进行故障排除和分析.

![top-services](https://github.com/user-attachments/assets/749dd237-3021-439d-b447-64605393389d)

## 认证

如何认证取决于连接方法 :

| 方法 | URL / 命令 | 认证 |
| --- | --- | --- |
| 远程( Streamable HTTP) | `https://mcp.doit.com/mcp` | OAuth — 您的客户端打开了 DoiT 签名和同意页 。 无头客户端可以发送客户个人 API 令牌作为 `Authorization: Bearer`。 。 。 . |
| 当地( stdio) | `npx -y @doitintl/doit-mcp-server@latest` | 个人 API 令牌通过 `DOIT_API_KEY`。 。 。 . |

遗留的SSE 终点( :`https://mcp.doit.com/sse`)已贬值,不应用于新设置.

您的 DoiT 计划必须包含 API 访问 。 工具跟随相同的权限 [Doit API (英语)](https://developer.doit.com/)。 。 。 .

工具结果上限为140 000个响应后序列化的UTF-16代码单元 格式化,包括结构化内容和元数据. 超大小读取返回 a 可操作错误; 已完成的写入返回压缩成功收件, 且不能 重复只为获取输出。 错误仍为错误。 这是回应 大小策略,不是符号限制,也不是在上游下载时绑定.

每个发送的呼叫都发出无载荷的JSON `mcp_tool_response` 以 stderr 为标准的事件 ; 一些客户端显示这些日志。 主机可以提供 `onResponseMetrics` 把事件带到别的地方 使用 `original.serializedChars` 响应大小 百分位数和 `exceededLimit` 超限费率; `returned` 衡量结果 侍卫之后 计量还包括UTF-8字节计数、持续时间、工具/客户端以及 没有工具参数或反应机构.

下面的克洛德桌面步骤是实例,并非唯一的支持客户端. Cursor, VS 代码, Amazon Q, Claude 代码等都包含在其中 [连接](https://help.doit.com/docs/mcp/connections) 向导.

## 远程( Streamable HTTP)

使用 Claude 桌面示例: 添加自定义连接符( C)**\+ + 添加连接器 + 添加自定义连接器**)并设置远程 MCP 服务器 URL `https://mcp.doit.com/mcp`在提示时完成 DoiT 签名.

### 无头客户端( API 令牌)

无法打开浏览器的代理( 例如集群上的福尔摩斯GPT, CI 任务, cron 工人) 可以与客户验证到同一端点 [个人 API 令牌](https://help.doit.com/docs/general/profile/api-tokens) 作为无记名信头发送。 工具运行 与该令牌的权限, 正是在stdio。 DoiT员工代币在远程端被不接受;员工使用OAuth或本地服务器.

福尔摩斯GPT示例:

```yaml
mcp_servers:
  doit:
    description: "DoiT Cloud Intelligence"
    config:
      url: "https://mcp.doit.com/mcp"
      mode: streamable-http
      headers:
        Authorization: "Bearer {{ env.DOIT_API_KEY }}"
      health_check_tool: "validate_user"
```

将信使放入秘密店并按期旋转. 设计注释 : [文件/远程钥匙携带者-自动](https://npmcn.com/package/%40doitintl/doit-mcp-server/docs/remote-api-key-bearer-auth.md)。 。 。 .

## 当地( stdio)

支助 [技能超过 MCP](https://npmcn.com/package/%40doitintl/doit-mcp-server/docs/skills.md) 用于兼容客户端。 没有技能被默认捆绑 .

要求node.js v20 或更高 个人 API 令牌为 `DOIT_API_KEY`。从 [个人 API 令牌](https://help.doit.com/docs/general/profile/api-tokens) doiT控制台中的页面.

使用 Claude 桌面的示例—— 将以下添加到 `claude_desktop_config.json` (或设置),然后 [重新启动 Claude](https://modelcontextprotocol.io/quickstart/user#3-restart-claude)数字 :

```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`: 客户上下文标识符(可选)

### 支持的 MCP 协议版本

Stdio服务器与两个MCP协议时代的客户端合作,没有任何配置:

-   `2024-10-07` 结束 `2025-11-25`,通过 `initialize` 握个手.
-   `2026-07-28`,通过 `server/discover`。 。 。 .

每个连接的开口信息决定它使用的时代. 见 [文件/议定书兼容性](https://npmcn.com/package/%40doitintl/doit-mcp-server/docs/protocol-compatibility.md) 细节和检验结果.

### 克隆到本地仓库

如果您想直接从源代码中复制和运行这个MCP服务器,请遵循这些步骤:

1.  **清除仓库**

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

2.  **安装依赖关系**

```bash
yarn install
```

3.  **构建工程**

```bash
yarn build
```

4.  **运行服务器**

```bash
DOIT_API_KEY=your_doit_api_key node dist/index.js
```

## 核心软件包 API

提供自己MCP运输的应用程序可以重新使用已公布的, 运输独立实施:

```bash
npm install @doitintl/doit-mcp-server@latest
```

```ts
import {
    COVERED_ENDPOINTS,
    executeToolHandler,
    generateTools,
    generatedToolsOpenApiSpec,
    HAND_WRITTEN_TOOLS,
} from "@doitintl/doit-mcp-server/core";
```

这个 `/core` 条目包括工具和即时定义,生成工具 公用事业、请求处理和共享配置 API。 它没有初始化 或包括Cloudflare工人、OAuth、持久物体,或 部件执行.

### 重大成果

克劳德接受每个工具结果大约15万个字符,所以 `executeToolHandler` 以14万个字符为每个结果封顶。 超过上限的列表结果为 返回为部分而不是失败: 服务器保存合适的记录, 添加 `pageSplit: { returnedRecords, remainingInResult }`设置 `pageToken` 签 名 续作符. 将信使递回同一个工具返回下一个部分; aPI 本身的光标仅在整个 API 页面发送后才会出现, 因此没有 记录被跳过或重复。 如果记录中停止的部分在 接下来的通话,继续按其指数恢复,所以重复记录而不是 跳过 Page 是选入: 一个只读列表工具,其端点为 没有呼喊自己的声明 `resultPaged: true` (工具对象上的手写工具, 生成的 `src/tools/generated/overrides.ts`)并获得可选 `pageToken` 参数。 单一资源工具没有可拆分的,阅读时不能重运行 (单位:千美元)`ask_ava_sync`别过来 分析结果`rows`)从不分裂,并保持大小 错误并带有缩小的提示。 记录收藏以外的字段( 计数、 兄弟姐妹) 诸如组件等地图 `statussheet`)描述整个结果,并在每个 页:1 登记生成的登记图的消费者在 已选择生成工具并应当通过 `resultPaging` 因此它产生效果.

Stdio服务器以随机的每个进程的秘密来签名符. 一个消费者 提供自己的运输通行证 `resultPaging: { secret, cursorField }` 改为 `executeToolHandler`,并应用 `withResultPageToken` 切换到每一个的 zod 策略 工具输入 `RESULT_PAGED_TOOLS` 当它从输出的策略中注册工具时 两家运输公司都宣传同样的论点.

## 用法实例

以下是一些常见的查询, 您可以使用 DoiT MCP 服务器询问 :

### 成本分析和节余

-   "我的弹性储蓄是什么?" 这将分析你的弹性 成本优化节省 通过你的云账户.
-   "按成本计算,我最好的3AWS服务是什么?" 这将运行一个 Cloud Analytics 查询, 以识别您花费最高的 AWS 服务 .

### 报告和分析

-   "记录我所有的报告" 这将显示所有云分析报告 你访问.
-   "给我看看我的"每月成本概览"报告的结果" 这将获取并显示具体报告的结果.

### 异常检测

-   "我最近的GCP异常情况是什么?" 这将显示在您的 Google Cloud 平台账户中检测到的最新成本或使用异常 .
-   "给我看关于异常点ABC123的细节"——这将提供具体异常点的详细信息.

### 发票

-   "把我的发票都写下来" 这将显示您组织的当前和历史发票.
-   "给我看看发票INV-2024-001的细节"——这将提供具体发票的全部细节,包括细列项目和付款状况.

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

## Claude 代码插件和频道( 研究预览)

此寄存器中的 Claude 代码插件将新的成本异常和云事件推入一个开放会话. 它只发送事件;工具来自多伊特云智能插件或远程连接器.

```
/plugin install doit --marketplace doitintl/doit-mcp-server
```

见 [文档/频道](https://npmcn.com/package/%40doitintl/doit-mcp-server/docs/channels.md) 如何启动Claude Code的频道 一个组织需要允许什么.

## 环境变量

由当地stdio服务器使用. 远程 `/mcp` 连接认证到 OAuth .

-   `DOIT_API_KEY`: 您的 DoiT 密码 [个人 API 令牌](https://help.doit.com/docs/general/profile/api-tokens) (stdio需要时)
-   `CUSTOMER_CONTEXT`: 您的客户上下文标识符( 可选)
-   `DOIT_CHANNEL_EVENTS`: 打开 [Claude 代码频道模式](https://npmcn.com/package/%40doitintl/doit-mcp-server/docs/channels.md) (研究预览) 通过列出活动类型来推动一个开放会话: `anomalies`, (中文(简体) ), `incidents` (可选,默认关闭)
-   `DOIT_CHANNEL_POLL_SECONDS`: 频道民调间隔以秒为单位, 最少为60( 可选, 默认为300)
-   `DOIT_CHANNEL_ONLY`: 设定为 `true` 为有来自另一个连接的 DoiT 工具的会话服务频道事件和没有工具( 可选)

## 常见问题

### @doitintl/doit-mcp-server 是什么？

DoiT 官方 MCP 服务器

### 如何安装 @doitintl/doit-mcp-server？

在项目目录运行 npm install @doitintl/doit-mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 doit-mcp-server，可以用 npx doit-mcp-server 直接运行。

### @doitintl/doit-mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @doitintl/doit-mcp-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @doitintl/doit-mcp-server 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @doitintl/doit-mcp-server 可以商用吗？

@doitintl/doit-mcp-server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @doitintl/doit-mcp-server 的下载量有多少？

根据 npm 官方下载统计，@doitintl/doit-mcp-server 在 2026/10/13 – 2026/11/11 这 30 天内被下载 12,985 次，日均约 433 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @doitintl/doit-mcp-server 还在维护吗？

最新版本 4\.0\.0 发布于 2026/11/12（1 天前）；至今共发布 79 个版本，其中过去 12 个月发布了 64 个；首次发布于 2025/05/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。