# @arizeai/phoenix-mcp 中文文档

规范地址：https://npmcn.com/package/%40arizeai/phoenix-mcp/

版本：4\.3\.20
npm 元数据更新时间：2026-11-02T18:14:25.759Z
中文译文更新时间：2026-11-06T19:28:52.452Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40arizeai/phoenix-mcp
原文对照：https://npmcn.com/package/%40arizeai/phoenix-mcp/?lang=original
项目主页：https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-mcp
源码仓库：https://github.com/Arize-ai/phoenix

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

- 包体积（解压后）：120 kB，27 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：6 个
- 首次发布：2025-04-04T22:19:35.605Z
- 最新版本发布：2026-11-02T18:14:25.416Z
- 近 30 天下载量：5164（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：110（近 12 个月 73 个）

## 中文简介

阿里泽凤凰的 MCP 服务器

## 安装

```sh
npm install @arizeai/phoenix-mcp
```

也可以使用：`pnpm add @arizeai/phoenix-mcp`、`yarn add @arizeai/phoenix-mcp`、`bun add @arizeai/phoenix-mcp`

## README

# 

[![Arize Phoenix logo](https://raw.githubusercontent.com/Arize-ai/phoenix-assets/refs/heads/main/logos/Phoenix/phoenix.svg)](https://phoenix.arize.com/?utm_medium=github&utm_content=header_img&utm_campaign=phoenix-mcp)  
阿里泽凤凰MCP服务器

 [![NPM Version](https://img.shields.io/npm/v/%40arizeai%2Fphoenix-mcp)](https://www.npmjs.com/package/@arizeai/phoenix-mcp)[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg) ](https://github.com/Arize-ai/phoenix/blob/main/js/packages/phoenix-mcp/LICENSE)![](https://badge.mcpx.dev/?status=on "MCP Enabled") [![Add Arize Phoenix MCP server to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg) ](https://cursor.com/install-mcp?name=phoenix&config=eyJjb21tYW5kIjoibnB4IC15IEBhcml6ZWFpL3Bob2VuaXgtbWNwQGxhdGVzdCAtLWJhc2VVcmwgaHR0cDovL2xvY2FsaG9zdDo2MDA2IC0tYXBpS2V5IHlvdXItYXBpLWtleSJ9)![](https://static.scarf.sh/a.png?x-pxid=8e8e8b34-7900-43fa-a38f-1f070bd48c64&page=js/packages/phoenix-mcp/README.md)

凤凰MCP 服务器是阿里泽凤凰平台的"示范背景协议"的实施. 它为凤凰城的能力提供了统一的接口.

您可以使用 Phoenix MCP 服务器 :

-   **项目管理**: 列出和探索组织您可观察性数据的项目
-   **追踪、 螺旋和说明**: 获取用于分析和调试的痕迹、跨度和注释配置
-   **会议**: 探索对话流程和会话级别说明
-   **提示管理**: 创建、 列出、 更新和在提示上斜拉
-   **数据集**: 探索数据集并综合新实例
-   **实验**:在LLM的帮助下,拉出实验结果并将其可视化

没看到用具盖上吗? `@arizeai/phoenix-mcp` 实值 [开源](https://github.com/Arize-ai/phoenix)问题和公关欢迎.

## 安装

可用此 MCP 服务器 `npx` 并可以直接与Claude Desktop, Cursor等客户端集成.

```json
{
  "mcpServers": {
    "phoenix": {
      "command": "npx",
      "args": [
        "-y",
        "@arizeai/phoenix-mcp@latest",
        "--baseUrl",
        "https://my-phoenix.com",
        "--apiKey",
        "your-api-key"
      ]
    }
  }
}
```

## 发展

## 安装

此软件包通过 pnpm 工作空间管理 .

```sh
// From the /js/ directory
pnpm install
pnpm build
```

只有在依赖关系发生变化或凤凰客户端出现变化时,才能重复出现这种情况.

### 大楼

为建设该项目:

```sh
pnpm build
```

### 发展模式

要以开发模式运行 :

```bash
pnpm dev
```

### 调试

您可通过下列方式建立并管理 MCP 检查员:

```bash
pnpm inspect
```

## 环境变量

开发时,服务器需要下列环境变量:

-   `PHOENIX_API_KEY`: 您的凤凰 API 密钥
-   `PHOENIX_ENDPOINT`: 凤凰的基础 URL
-   `PHOENIX_PROJECT`: 项目范围工具的可选默认项目(别名: `PHOENIX_PROJECT_NAME`(中文(简体) )
-   `PHOENIX_CLIENT_HEADERS`: 可选 JSON 编码请求头

把这些设置在 `.env` 文档。 见 `.env.example`。 。 。 .

运行时服务器也会发现最近的 `.env.phoenix` 文件位于或位于 在工作目录上方。 进程环境变量和命令行 选项优先。 如果更高优先级的 API 密钥被配对 端点来自文件,服务器警告一次并持续. 设定 `PHOENIX_DISCOVER_CONFIG=false` 以禁用发现.

## 工具覆盖

MCP服务器覆盖主要运营凤凰网工作流程:

**提示** —— 说 `list-prompts`, (中文(简体) ), `get-prompt`, (中文(简体) ), `get-latest-prompt`, (中文(简体) ), `get-prompt-by-identifier`, (中文(简体) ), `get-prompt-version`, (中文(简体) ), `list-prompt-versions`, (中文(简体) ), `get-prompt-version-by-tag`, (中文(简体) ), `list-prompt-version-tags`, (中文(简体) ), `add-prompt-version-tag`, (中文(简体) ), `upsert-prompt`

**项目** —— 说 `list-projects`, (中文(简体) ), `get-project`

**追踪** —— 说 `list-traces`, (中文(简体) ), `get-trace`

**西班牙语** —— 说 `get-spans`, (中文(简体) ), `get-span-annotations`

**会议** —— 说 `list-sessions`, (中文(简体) ), `get-session`

**注释配置** —— 说 `list-annotation-configs`

**数据集** —— 说 `list-datasets`, (中文(简体) ), `get-dataset`, (中文(简体) ), `get-dataset-examples`, (中文(简体) ), `get-dataset-experiments`, (中文(简体) ), `add-dataset-examples`

**实验** —— 说 `list-experiments-for-dataset`, (中文(简体) ), `get-experiment-by-id`

对于凤凰的文档搜索,使用单独的凤凰Docs MCP服务器来代替这个软件包.

## 社区

加入我们的社区,与成千上万的人工智能建设者建立联系:

-   加入我们的行列 [黑社会](https://join.slack.com/t/arize-ai/shared_invite/zt-3r07iavnk-ammtATWSlF0pSrd1DsMW7g)。 。 。 .
-   读取 [凤凰网文献](https://arize.com/docs/phoenix)。 。 。 .
-   \* 提问并提供反馈 _#凤凰支持 #_ 频道.
-   留下一颗星星在我们身上 [GitHub 图像](https://github.com/Arize-ai/phoenix)。 。 。 .
-   报告错误 [GitHub 问题](https://github.com/Arize-ai/phoenix/issues)。 。 。 .
-   X 跟着我们 [页:1](https://twitter.com/ArizePhoenix)。 。 。 .
-   跟着我们 [链接](https://www.linkedin.com/showcase/113218220)。 。 。 .
-   看看我们 [路线图](https://github.com/orgs/Arize-ai/projects/45) 看看我们下一步要去哪儿.

## 许可证

Apache 2.0 (英语)

## 常见问题

### @arizeai/phoenix-mcp 是什么？

阿里泽凤凰的 MCP 服务器

### 如何安装 @arizeai/phoenix-mcp？

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

### @arizeai/phoenix-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/arizeai\_\_phoenix-mcp 是否存在。

### @arizeai/phoenix-mcp 支持 ESM 还是 CommonJS？

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

### @arizeai/phoenix-mcp 可以商用吗？

@arizeai/phoenix-mcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @arizeai/phoenix-mcp 的下载量有多少？

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

### @arizeai/phoenix-mcp 还在维护吗？

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