# @dynatrace-oss/dynatrace-mcp-server 中文文档 规范地址：https://npmcn.com/package/%40dynatrace-oss/dynatrace-mcp-server/ 版本：2\.1\.2 npm 元数据更新时间：2026-07-21T10:14:16.599Z 中文译文更新时间：2026-11-13T02:32:43.251Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40dynatrace-oss/dynatrace-mcp-server 原文对照：https://npmcn.com/package/%40dynatrace-oss/dynatrace-mcp-server/?lang=original 项目主页：https://github.com/dynatrace-oss/dynatrace-mcp#readme 源码仓库：https://github.com/dynatrace-oss/dynatrace-mcp 弃用说明：Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\. ## 关键信息（来自 npm 元数据） - 包体积（解压后）：7.8 MB，7 个文件 - 模块格式：CommonJS - TypeScript 类型：未声明 - 运行依赖：2 个 - 首次发布：2025-04-30T15:56:17.213Z - 最新版本发布：2026-07-20T19:29:36.803Z - 近 30 天下载量：85273（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：160（近 12 个月 134 个） ## 中文简介 \[DEPRECATED\]用于Dynatrace的模型上下文协议(MCP)服务器. 迁移到 dynatrace- for-ai + dtctl 或 Dynatrace 远程 MCP 服务器. ## 安装 ```sh npm install @dynatrace-oss/dynatrace-mcp-server ``` 也可以使用：`pnpm add @dynatrace-oss/dynatrace-mcp-server`、`yarn add @dynatrace-oss/dynatrace-mcp-server`、`bun add @dynatrace-oss/dynatrace-mcp-server` ## README # Dynatrace MCP 服务器 #### [![](https://img.shields.io/github/release/dynatrace-oss/dynatrace-mcp)](https://github.com/dynatrace-oss/dynatrace-mcp/releases)[![Dynatrace MCP Server is released under the MIT License](https://img.shields.io/badge/license-mit-blue.svg) ](https://github.com/dynatrace-oss/dynatrace-mcp/blob/main/LICENSE)[![](https://img.shields.io/badge/Install_in-VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white) ](https://vscode.dev/redirect/mcp/install?name=dynatrace-mcp-server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40dynatrace-oss%2Fdynatrace-mcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)[![](https://img.shields.io/badge/Install_in-Cursor-000000?style=flat-square&logoColor=white) ](https://npmcn.com/package/%40dynatrace-oss/dynatrace-mcp-server/[https://vscode.dev/redirect/mcp/install?name=dynatrace-mcp-server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40dynatrace-oss%2Fdynatrace-mcp-server%22%5D%2C%22env%22%3A%7B%7D%7D]\(https://cursor.com/en/install-mcp?name=dynatrace-mcp-server&config=eyJuYW1lIjoiZHluYXRyYWNlLW1jcC1zZXJ2ZXIiLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBkeW5hdHJhY2Utb3NzL2R5bmF0cmFjZS1tY3Atc2VydmVyIl0sImVudiI6e319\))[![npm](https://img.shields.io/npm/dm/@dynatrace-oss/dynatrace-mcp-server?logo=npm&style=flat&color=red) ](https://www.npmjs.com/package/@dynatrace-oss/dynatrace-mcp-server)[![Dynatrace MCP Server Stars on GitHub](https://img.shields.io/github/stars/dynatrace-oss/dynatrace-mcp) ](https://github.com/dynatrace-oss/dynatrace-mcp)[![Dynatrace MCP Server Contributors on GitHub](https://img.shields.io/github/contributors/dynatrace-oss/dynatrace-mcp?color=green)](https://github.com/dynatrace-oss/dynatrace-mcp) ## 被否决 > **这个寄存器被贬值. 2.1.2版是最后发行的版本——将不作进一步更新.** 请迁移到积极维护的备选方案之一: | 使用大小写 | 建议的工具 | | --- | --- | | **地方发展** (VS代码, IntelliJ, Claude代码, Cursor,.) | [Dynatrace for-AI (英语)](https://github.com/Dynatrace/dynatrace-for-ai/) + 键 [`dtctl`](https://github.com/dynatrace-oss/dtctl) | | **代理对代理 / 远程** (阿特拉斯西安·罗沃,GitHub编码代理 | [Dynatrace 远程 MCP 服务器](https://www.dynatrace.com/hub/detail/dynatrace-mcp-server/) ——不需要本地设置 | 见 [移徙指南](https://npmcn.com/package/%40dynatrace-oss/dynatrace-mcp-server/docs/remote-mcp-migration.md) 逐步比较和移民指示. 当地 _Dynatrace MCP 服务器_ 允许 AI 助手与 [色调](https://www.dynatrace.com/) 观察平台, 将实时可观测数据直接带入您的开发工作流程. > 说明: 这个产品并没有得到Dynatrace的官方支持. 如果你需要帮助,请联系我们 [GitHub 问题](https://github.com/dynatrace-oss/dynatrace-mcp/issues) 如果您有特性请求、问题或需要帮助. [https://github.com/user-attachments/assets/25c05db1-8e09-4a7f-add2-ed486ffd4b5a 互联网档案馆的存檔,存档日期2013-12-2](https://github.com/user-attachments/assets/25c05db1-8e09-4a7f-add2-ed486ffd4b5a) ## 先决条件 - **节点.js v24 或更新** 需要运行 Dynatrace MCP 服务器. ## 快速启动 您可以在您的 MCP 客户端中添加此 MCP 服务器, 如 VSCode, Claude, Cursor, Amazon Q, Windsurf, ChatGPT, 或通过命令的 Github Copilot 是 `npx -y @dynatrace-oss/dynatrace-mcp-server` (类型 : `stdio`) (中文(简体) ). 详细情况请参见 [下面的配置部分](https://npmcn.com/package/%40dynatrace-oss/dynatrace-mcp-server/#readme-configuration)。 。 。 . 此外,您需要将 URL 配置到 Dynatrace 环境 : - `DT_ENVIRONMENT` (弦,如:, `https://abc12345.apps.dynatrace.com`) - URL 到您的 Dynatrace 平台( 不使用 Dynatrace 等经典 URL) `abc12345.live.dynatrace.com`(中文(简体) ) 认证将在浏览器中通过授权代码流程处理, 您不需要定义一个 Platface Token 或 OAuth 客户端即可启动 。 初始认证后, 您的令牌将安全保存在 **OS 键链** (macOS keychain,Windows Creditential Manager,或Linux Secret Service) 并在随后的服务器上被再用,因此浏览器每个符号寿命只打开一次. 如果您运行在一个没有OS键链的无头/ 容器环境中, 请设定 `DT_MCP_TOKEN_STORAGE=file` 以表示 `~/.config/dynatrace-mcp/` 换句话说. 一旦你完成 我们建议调查 [示例提示](https://npmcn.com/package/%40dynatrace-oss/dynatrace-mcp-server/#readme--example-prompts-)一样 `Get all details of the entity 'my-service'` 或者说 `Show me error logs`。请注意,这些提示可能导致执行 DQL 报表,从而可能导致 [费用](https://npmcn.com/package/%40dynatrace-oss/dynatrace-mcp-server/#readme-costs) 根据您的执照. **虚拟系统** ```json { "servers": { "npx-dynatrace-mcp-server": { "command": "npx", "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"], "env": { "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com" } } } } ``` ## 建筑 ![Architecture](https://github.com/dynatrace-oss/dynatrace-mcp/blob/main/assets/dynatrace-mcp-arch.png?raw=true) ## 使用大小写 - **实时观察** - 获取生产一级数据,以进行早期检测和主动监测 - **背景调试** - 从受监测的例外情况、记录和异常情况中充分处理问题 - **安全见解** - 进行详细的弱点分析和追踪安全问题 - **自然语言查询** - 使用AI驱动的DQL生成和解释 - **多阶段事件调查** - 系统化的四阶段办法,自动进行影响评估 - **高级交易分析** - 精确的根因子识别,文件/行级准确性 - **跨数据源关联** - 连接问题 · 跨度 · 有痕量识别关联的日志 - **DevOps 自动化** - 安装自动升级/回滚逻辑的卫生门 - **安全遵守情况监测** - 对循证调查进行多云遵守情况评估 ## 能力 - 可观察性和问题管理(例如, `list_problems`, (中文(简体) ), `list_vulnerabilities`, (中文(简体) ), `list_exceptions`, (中文(简体) ), `get_kubernetes_events`(中文(简体) ) - 来自圣杯的查询数据(例如, `execute_dql`, (中文(简体) ), `verify_dql`, (中文(简体) ), `generate_dql_from_natural_language`, (中文(简体) ), `explain_dql_in_natural_language`(中文(简体) ) - 实体发现(例如, `find_entity_by_name`(中文(简体) ) - [Dynatrace 情报](https://www.dynatrace.com/platform/artificial-intelligence/) (例如, `chat_with_davis_copilot`, (中文(简体) ), `list_davis_analyzers`, (中文(简体) ), `execute_davis_analyzer`(中文(简体) ) - 自动化和通知(例如, `send_slack_message`, (中文(简体) ), `send_email`, (中文(简体) ), `send_event`(中文(简体) ) - 共享成果(例如, `create_dynatrace_notebook`(中文(简体) ) ### 费用 **重要内容:** 虽然这个本地的MCP服务器是免费提供的,但利用某些能力访问Dynatrace Grail的数据可能会产生额外的费用 在你的Dynathrace消费模式。 这影响 `execute_dql` 工具和其他能力 **查询** Dynatrace 圣杯储存和费用 取决于体积(GB扫描). **在广泛使用此 MCP 服务器之前, 请 :** 1. 检查您的当前 Dynatrace 消费模式和定价 2. 了解您计划查询的具体数据的成本影响(日志、事件、衡量标准)-参见 [Dynatrace 定价和收费卡](https://www.dynatrace.com/pricing/) 3. 以较小的时间框架(例如12h-24h)起步,并利用 [桶头](https://docs.dynatrace.com/docs/discover-dynatrace/platform/grail/data-model#built-in-grail-buckets) 减少成本影响 4. 设置一个合适的 `DT_GRAIL_QUERY_BUDGET_GB` 控制并监视您圣杯查询消耗的环境变量( 默认值: 1000 GB) **圣杯预算跟踪:** MCP 服务器包括用于 Grail 查询的内置预算跟踪, 帮助您监测和控制成本 : - 设定 `DT_GRAIL_QUERY_BUDGET_GB` (默认: 1000 GB) 以定义您的会话预算限制 - 服务器跟踪字节扫描到当前会话中的所有圣杯查询 - 接近预算80%时会收到警告 - 预算超过警戒,有助于防止意外高消费量 - 当您重新启动 MCP 服务器会话时, 预算重排 **了解所发生的费用:** 在笔记本中执行以下 DQL 语句, 查看圣杯( 日志、 事件等) 询问了多少字节 : ``` fetch dt.system.events | filter event.kind == "QUERY_EXECUTION_EVENT" and contains(client.client_context, "dynatrace-mcp") | sort timestamp desc | fields timestamp, query_id, query_string, scanned_bytes, table, bucket, user.id, user.email, client.client_context | maketimeSeries sum(scanned_bytes), by: { user.email, user.id, table } ``` ### 大赦国际授权的援助 - **自然语言到 DQL** - 将纯英语查询转换为 Dynatrace 查询语言 - **DQL 解释** - 对复杂的DQL查询获得简单的英文解释 - **AI聊天助理** - 为Dynatrace问题获得相关帮助和指导 ## 配置 您可以通过软件包将这个 MCP 服务器( 使用 STDIO) 添加到您的 MCP 客户端中, 例如 VS 代码, Claude, Cursor, Amazon Q 开发者 CLI, Windsurf Github Copilot `@dynatrace-oss/dynatrace-mcp-server`。 。 。 . 我们建议永远为您现在的工作空间 而不是在全球使用它. **VS 代码** ```json { "servers": { "npx-dynatrace-mcp-server": { "command": "npx", "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"], "env": { "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com" } } } } ``` **克劳德桌面** ```json { "mcpServers": { "dynatrace-mcp-server": { "command": "npx", "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"], "env": { "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com" } } } } ``` **亚马逊 Q 开发者 CLI** 这个 [亚马逊 Q 开发者 CLI](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html) 在您的终端直接提供交互聊天体验。 您可以询问问题,获得AWS服务的帮助,故障排除问题,并生成代码片段,而不离开命令行环境. ```json { "mcpServers": { "dynatrace-mcp-server": { "command": "npx", "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"], "env": { "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com" } } } } ``` 此配置应存储于 `/.amazonq/mcp.json`。 。 。 . **亚马逊基罗** 这个 [亚马逊基罗](https://kiro.dev/) 是一种代理式的IDE,它帮助您用像规格,方向盘,和钩子这样的特性来完成你最好的工作. ```json { "mcpServers": { "dynatrace-mcp-server": { "command": "npx", "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"], "env": { "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com" } } } } ``` 此配置应存储于 `/.kiro/settings/mcp.json`。 。 。 . **谷歌双子座CLI** 这个 [谷歌双子座CLI](https://github.com/google-gemini/gemini-cli) 是Google支持MCP服务器集成的官方命令行AI助手. 您可以使用内置管理命令或手动配置添加 Dynatrace MCP 服务器 . 使用 `gemini` 直接CLI(建议): ```bash gemini extensions install https://github.com/dynatrace-oss/dynatrace-mcp export DT_PLATFORM_TOKEN=... # optional ``` 命令将询问 Dynatrace 环境值 . 验证服务器是否正在通过 ```bash gemini mcp list ``` 或手动在你的 `~/.gemini/settings.json` 或者说 `.gemini/settings.json`数字 : ```json { "mcpServers": { "dynatrace": { "command": "npx", "args": ["@dynatrace-oss/dynatrace-mcp-server@latest"], "env": { "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com" }, "timeout": 30000, "trust": false } } } ``` ### HTTP 服务器模式( 替代) > **建议:** 而不是自我接待与 `--http` 编号 : `--server`,考虑使用官方 [Dynatrace 远程 MCP 服务器](https://www.dynatrace.com/hub/detail/dynatrace-mcp-server/) 它更加安全,始终是最新的,不需要基础设施管理. 对于需要将MCP服务器运行为HTTP服务而非使用stdio的情景(例如用于状态会话,加载平衡,或与网络客户端整合),您可以使用HTTP服务器模式: **作为 HTTP 服务器运行 :** 请用无记名符号保护您的服务器 : ```bash export MCP_BEARER_TOKEN= ``` ```bash # Get help and see all available options npx -y @dynatrace-oss/dynatrace-mcp-server@latest --help # Run with HTTP server on default port 3000 npx -y @dynatrace-oss/dynatrace-mcp-server@latest --http # Run with custom port (using short or long flag) npx -y @dynatrace-oss/dynatrace-mcp-server@latest --server -p 8080 npx -y @dynatrace-oss/dynatrace-mcp-server@latest --http --port 3001 # Run with custom host/IP (using short or long flag) npx -y @dynatrace-oss/dynatrace-mcp-server@latest --http --host 127.0.0.1 # recommended for local computers npx -y @dynatrace-oss/dynatrace-mcp-server@latest --http --host 0.0.0.0 # required for container (binds all interfaces; omitting --host defaults to 127.0.0.1) npx -y @dynatrace-oss/dynatrace-mcp-server@latest --http -H 192.168.0.1 # recommended when sharing connection over a local network # Static OAuth callback port (useful when the port must be exposed, e.g., when running the MCP in a container) npx -y @dynatrace-oss/dynatrace-mcp-server@latest --oauth-redirect-port 5344 # Check version npx -y @dynatrace-oss/dynatrace-mcp-server@latest --version ``` **支持 HTTP 传输的 MCP 客户端配置 :** ```json { "mcpServers": { "dynatrace-http": { "url": "http://localhost:3000", "transport": "http", "headers": { "Authorization": "Bearer " } } } } ``` #### 熊鼠托肯认证( E)`MCP_BEARER_TOKEN`(中文(简体) ) `MCP_BEARER_TOKEN` 实值 **所需经费** 在 HTTP 模式下运行时。 如果未设定此变量, 服务器将拒绝启动 . 每一个 HTTP 请求必须包含 `Authorization: Bearer ` 头曰. 没有有效代号的请求收到 `401 Unauthorized`。 。 。 . **生成一个安全标志 :** ```bash export MCP_BEARER_TOKEN=$(openssl rand -base64 32) npx -y @dynatrace-oss/dynatrace-mcp-server@latest --http ``` **配置 MCP 客户端以发送符号 :** ```json { "mcpServers": { "dynatrace-http": { "url": "http://localhost:3000", "transport": "http", "headers": { "Authorization": "Bearer " } } } } ``` ### MCP套装(MCPB) 每个发布会发布一个预建的MCP Bundle文件(`.mcpb`)可以直接安装在克洛德桌面,而无需任何手动JSON配置. **在 Claude 桌面安装 :** 1. 转到 [GitHub 发布](https://github.com/dynatrace-oss/dynatrace-mcp/releases) 页面和下载最新 `dynatrace-mcp-server-.mcpb` 文档. 2. 双击已下载 `.mcpb` 文件,或打开 Claude 桌面 **设置** → **开发者** ,然后将文件拖入 MCP 服务器列表. 3. 跟随提示设置 `DT_ENVIRONMENT` 变量(例如:. `https://abc12345.apps.dynatrace.com`) (中文(简体) ). 该存储库还包括一个MCP Bundle兼容程序 [显示. json](https://npmcn.com/package/%40dynatrace-oss/dynatrace-mcp-server/manifest.json) 用于当地安装. 捆绑通过 stdio 运行编译的本地服务器入口 : - `server.type`数字 : `node` - `server.entry_point`数字 : `dist/index.js` - `mcp_config.command`数字 : `node` - `mcp_config.args`数字 : `["${__dirname}/dist/index.js"]` ### 规则文件 为了从 Dynatrace 中有效检索结果,请考虑创建一个规则文件(例如, [.github/副驾驶-指示](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions), (中文(简体) ), [.amazonq/规则/规则](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/context-project-rules.html)),指导编码代理如何为您的组件/应用程序/服务获取更多细节. 举个例子 [简单贸易](https://github.com/Dynatrace/easytrade),请调整名称和过滤器,以适应您的使用大小写和组件: ``` # Observability We use Dynatrace as an Observability solution. This document provides instructions on how to get data for easytrade from Dynatrace using DQL. ## How to get any data for my App Depending on the query and tool used, the following filters can be applied to narrow down results: * `contains(entity.name, "easytrade")` * `contains(affected_entity.name, "easytrade")` * `contains(container.name, "easytrade")` For best results, you can combine these filters with an `OR` operator. ## Logs To fetch logs for easytrade, execute `fetch logs | filter contains(container.name, "easyatrade")`. For fetching just error-logs, add `| filter loglevel == "ERROR"`. ``` ## 环境变量 > **V1.0.0 中突破变化 :** MCP 服务器不再自动加载 `.env` 文档。 使用来自 a 的环境变量 `.env` 文件, 您需要配置您的 MCP 客户端, 以便使用本地变量装入环境变量 `envFile` 配置选项。 见 [配置示例](https://npmcn.com/package/%40dynatrace-oss/dynatrace-mcp-server/#readme-configuration) 详情见下文. - `DT_ENVIRONMENT` (单位:千美元)**所需经费**,字符串,例如, `https://abc12345.apps.dynatrace.com`) - URL 到您的 Dynatrace 平台( 不使用 Dynatrace 等经典 URL) `abc12345.live.dynatrace.com`(中文(简体) ) - `DT_PLATFORM_TOKEN` (可选,字符串,例如, `dt0s16.SAMPLE.abcd1234`) - Dynatrace 平台托肯 - `OAUTH_CLIENT_ID` (可选,字符串,例如, `dt0s02.SAMPLE`\- 替代品: Dynatrace OAuth 客户端标识(用于高级使用案例) - `OAUTH_CLIENT_SECRET` (可选,字符串,例如, `dt0s02.SAMPLE.abcd1234`) - 替代品: Dynatrace OAuth 客户端保密(用于高级用途) - `DT_SSO_URL` (可选,字符串,例如, `https://sso.dynatrace.com`) - 覆盖OSO URL用于OAuth认证. 默认情况下, SSO URL 从您的 Dynatrace 环境中自动发现 . - `DT_GRAIL_QUERY_BUDGET_GB` (可选的,数字的,默认的: `1000`) - 每一会话扫描的"圣杯"查询字节的预算限制为GB (Base 1000). MCP 服务器跟踪您的圣杯使用情况, 当接近或超过此限制时警告 . 当只是提供 `DT_ENVIRONMENT`,本地的 MCP 服务器将尝试打开一个浏览器窗口,以对 Dynatrace SSO进行认证. 关于其他认证方法的更多信息,请查看有关文件 [在 Dynatrace 创建平台](https://docs.dynatrace.com/docs/manage/identity-access-management/access-tokens-and-oauth-clients/platform-tokens),以及 [在 Dynatrace 创建 OAuth 客户端](https://docs.dynatrace.com/docs/manage/identity-access-management/access-tokens-and-oauth-clients/oauth-clients) 用于高级情景(服务用户、后端至后端通信). 此外,根据您使用的特性,可以配置以下变量: - `SLACK_CONNECTION_ID` (字符串) - 连接 ID of a [黑连接](https://docs.dynatrace.com/docs/analyze-explore-automate/workflows/actions/slack) ### 代理配置 MCP 服务器尊重公司环境的系统代理设置 : - `https_proxy` 或者说 `HTTPS_PROXY` (可选,字符串,例如, `http://proxy.example.com:8080`) - HTTPS 请求的代理服务器 URL - `http_proxy` 或者说 `HTTP_PROXY` (可选,字符串,例如, `http://proxy.example.com:8080`) - HTTP 请求的代理服务器 URL - `no_proxy` 或者说 `NO_PROXY` (可选,字符串,例如, `localhost,127.0.0.1,.local`) - 应当绕过代理服务器的主机名或域的逗号分隔列表 - `NODE_EXTRA_CA_CERTS` (可选,字符串,例如, `C:\some-path\certificate.pem`) - 设定时, 众所周知的" root" CA( 如 VeriSign) 将会随着额外的证书被扩展 **说明:** 这个 `no_proxy` 环境变量目前为信息目的被登录,但基础的HTTP客户端没有完全执行. 如果您需要绕过特定主机的代理服务器,请考虑配置您的代理服务器来处理这些排除. 带有代理的示例配置 : ```bash export HTTPS_PROXY=http://proxy.company.com:8080 export NO_PROXY=localhost,127.0.0.1,.company.local export DT_ENVIRONMENT=https://abc12345.apps.dynatrace.com ``` ### 认证的范围 根据您使用的特性,需要下列范围: **供平台托肯和OAuth客户端使用:** - `app-engine:apps:run` - 几乎所有工具都需要 - `app-settings:objects:read` - 读取应用程序设置 - 需要用于 `send_slack_message` 从 App-Settings 读取连接细节的工具 - `storage:buckets:read` - 需要为 `execute_dql` 读取存储在圣杯上的所有系统数据的工具 - `storage:logs:read` - 需要为 `execute_dql` 用于读取可靠监护人验证日志的工具 - `storage:metrics:read` - 需要为 `execute_dql` 用于读取可靠性监护人验证的衡量标准的工具 - `storage:bizevents:read` - 需要为 `execute_dql` 用于读取 bizevents 以进行可靠性监护人验证的工具 - `storage:spans:read` - 需要为 `execute_dql` 从圣杯读取跨度的工具 - `storage:entities:read` - 需要为 `execute_dql` 从圣杯读取实体的工具 - `storage:events:read` - 需要为 `execute_dql` 从圣杯读取事件的工具 - `storage:security.events:read`\- 需要为 `execute_dql` 从圣杯读取安全事件的工具 - `storage:system:read` - 需要为 `execute_dql` 从圣杯读取系统数据的工具 - `storage:user.events:read` - 需要为 `execute_dql` 从圣杯读取用户事件的工具 - `storage:user.sessions:read` - 需要为 `execute_dql` 从圣杯读取用户会话的工具 - `storage:smartscape:read` - 需要为 `execute_dql` 读取 Smartscape 数据的工具 - `storage:files:read` - 需要为 `execute_dql` 用于 DQL 的工具 `load` 查找数据的语句(例如, `/lookups/http_status_codes`(中文(简体) ) - `storage:events:write` - 需要为 `send_event` 将事件数据发送到 Dynatrace 的工具 - `davis-copilot:conversations:execute` - 执行谈话技巧(与副驾驶交谈) - `davis-copilot:nl2dql:execute` - 执行 Davis 副驾驶自然语言(NL)到 DQL 技能 - `davis-copilot:dql2nl:execute` - 执行 DQL 到自然语言(NL) 技能 - `davis:analyzers:read` - 列入清单和获得Davis分析器定义所需 - `davis:analyzers:execute` - 需要执行戴维斯分析器 - `email:emails:send` - 需要为 `send_email` 发送电子邮件的工具 - `document:documents:read` - 需要为 `list_documents` 财务报告和审定财务报表 `read_document` 用于列表和读取 Dynatrace 文档的工具(笔记本、 Dashboards、 Launchpads等) - `document:documents:write` - 需要为 `create_document` 创建新文档的工具 **页:1**数字 : - 0.12.0之前的版本要求范围 `app-engine:functions:run`,则不再需要. - 0.13.0之前的版本需要范围 `settings:objects:read` 财务报告和审定财务报表 `environment-api:entities:read`,则不再需要. ## 示例提示 你可以从“我的组件被Dynatrace监控了吗” 这么简单开始,然后用更精密的 [实例](https://npmcn.com/package/%40dynatrace-oss/dynatrace-mcp-server/examples/)。 。 。 . ## 解决问题 ### 认证问题 在大多数情况下,认证问题与缺失的瞄准镜或无效的令牌有关. 请确保您已添加上述所有所需的范围. **对于平台托肯斯:** 1. 校验您的平台 Token 中包含所有必要的范围 2. 确保您的令牌有效且不过期 3. 检查您的用户在您的 Dynatrace 环境中是否有所需的权限 **OAuth 客户端 :** 在与OAuth有关的问题上,你可以根据我们 [Dynatrace 开发者文档](https://developer.dynatrace.com/develop/access-platform-apis-from-outside/#get-bearer-token-and-call-app-function)。 。 。 . 建议使用下列API测试访问(要求最小范围) `app-engine:apps:run` 例如, `storage:logs:read`: 1. 使用 OAuth 客户端 ID 和 secret 来获取一个 Bearer Token( 仅有效几分钟): ```bash curl --request POST 'https://sso.dynatrace.com/sso/oauth2/token' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'grant_type=client_credentials' \ --data-urlencode 'client_id={your-client-id}' \ --data-urlencode 'client_secret={your-client-secret}' \ --data-urlencode 'scope=app-engine:apps:run storage:logs:read' ``` 2. 使用 `access_token` 作为下一个呼叫的无记名者响应上述呼吁: ```bash curl -X GET https://abc12345.apps.dynatrace.com/platform/management/v1/environment \ -H 'accept: application/json' \ -H 'Authorization: Bearer {your-bearer-token}' ``` 3. 你应该找到这样的结果: ```json { "environmentId": "abc12345", "createTime": "2023-01-01T00:10:57.123Z", "blockTime": "2025-12-07T00:00:00Z", "state": "ACTIVE" } ``` ### 获取圣杯数据的问题 圣杯在 Dynatrace Docs 有关于权限的专栏. 请参考 [https://docs.dynatrace.com/docs/discover-dynatrace/平板电脑/grail/data-model/sign-permissions-in-rail 互联网档案馆的存檔,存档日期2013-12-22](https://docs.dynatrace.com/docs/discover-dynatrace/platform/grail/data-model/assign-permissions-in-grail) 更多细节. ## 遥测 Dynatrace MCP服务器使用Dynatrace OpenKit BizEvents发送遥测数据来帮助改进产品. 这包括: - 服务器启动事件( E)`com.dynatrace-oss.mcp.server-start`(中文(简体) ) - 客户初始化事件( E)`com.dynatrace-oss.mcp.client-initialization`) - 哪个MCP客户端正在连接(例如VS代码,克洛德桌面,光标) - 工具使用事件( E)`com.dynatrace-oss.mcp.tool-usage`\- 哪些工具被称为成功/失败、执行期限 - 错误事件( E)`com.dynatrace-oss.mcp.error`) - 用于调试和改进的错误跟踪 所有遥测数据作为 **商务活动** 并且可以通过圣杯进行分析: ```dql fetch bizevents | filter startsWith(event.type, "com.dynatrace-oss.mcp") | sort timestamp DESC ``` **隐私和退出 :** - 遥测是 **默认启用** 但可以通过设置禁用 `DT_MCP_DISABLE_TELEMETRY=true` - 无法跟踪您 Dynatrace 环境中的敏感数据 - 只收集匿名使用统计和错误信息 - 用法统计和出错数据被传送到Dynatrace的分析端点 **配置选项 :** - `DT_MCP_DISABLE_TELEMETRY` (布尔, 默认值 : `false`\- 禁用遥测 - `DT_MCP_TELEMETRY_APPLICATION_ID` (字符串,默认值 : `dynatrace-mcp-server`\- 用于跟踪的应用程序ID - `DT_MCP_TELEMETRY_ENDPOINT_URL` (字符串,默认: Dynatrace 端点) - OpenKit 端点 URL - `DT_MCP_TELEMETRY_DEVICE_ID` (字符串,默认:自动生成) - 用于跟踪的设备标识符 要禁用用户跟踪, 请将此添加到您的环境中 : ```bash DT_MCP_DISABLE_TELEMETRY=true ``` ## 常见问题 ### @dynatrace-oss/dynatrace-mcp-server 是什么？ \[DEPRECATED\]用于Dynatrace的模型上下文协议\(MCP\)服务器\. 迁移到 dynatrace- for-ai \+ dtctl 或 Dynatrace 远程 MCP 服务器\.注意：该包已被作者标记为弃用——Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\. ### 如何安装 @dynatrace-oss/dynatrace-mcp-server？ 在项目目录运行 npm install @dynatrace-oss/dynatrace-mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-server-dynatrace，可以用 npx mcp-server-dynatrace 直接运行。 ### @dynatrace-oss/dynatrace-mcp-server 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dynatrace-oss\_\_dynatrace-mcp-server 是否存在。 ### @dynatrace-oss/dynatrace-mcp-server 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### @dynatrace-oss/dynatrace-mcp-server 可以商用吗？ @dynatrace-oss/dynatrace-mcp-server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @dynatrace-oss/dynatrace-mcp-server 的下载量有多少？ 根据 npm 官方下载统计，@dynatrace-oss/dynatrace-mcp-server 在 2026/10/13 – 2026/11/11 这 30 天内被下载 85,273 次，日均约 2,842 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @dynatrace-oss/dynatrace-mcp-server 还在维护吗？ 最新版本 2\.1\.2 发布于 2026/07/21（3 个月前）；至今共发布 160 个版本，其中过去 12 个月发布了 134 个；首次发布于 2025/04/30。作者已将其标记为弃用，新项目建议寻找替代方案。