# @elastic\.io/mcp 中文文档

规范地址：https://npmcn.com/package/%40elastic.io/mcp/

版本：1\.0\.0-beta8
npm 元数据更新时间：2026-11-12T14:38:04.781Z
中文译文更新时间：2026-11-13T23:58:34.885Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40elastic.io/mcp
原文对照：https://npmcn.com/package/%40elastic.io/mcp/?lang=original

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

- 包体积（解压后）：763 kB，174 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：9 个
- 首次发布：2026-09-30T13:22:49.764Z
- 最新版本发布：2026-11-12T14:38:04.321Z
- 近 30 天下载量：2795（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

elstic.io 模式上下文协议(MCP) 服务器

## 安装

```sh
npm install @elastic.io/mcp
```

也可以使用：`pnpm add @elastic.io/mcp`、`yarn add @elastic.io/mcp`、`bun add @elastic.io/mcp`

## README

# elstic.io 模式上下文协议(MCP) 服务器

连接 AI 助手到 **弹性.io** iPaaS平台——让他们直接发现,构建,修改并调试集成流.

## 使用条件

弹性.io MCP服务器是可选的. 通过将AI代理连接到elastic.io,你同意 [弹性.io 使用条件](https://www.elastic.io/terms-of-use/),特别是: _MCP 磁共振 接口和人工智能代理_ 节.

简而言之:

-   **你的经纪人就像你一样.** 你的人工智能探员通过MCP所做的一切 都是代表你的弹性.io账户做的.
-   **限制权限 .** 代理可以在您连接的用户账户权限范围内读取,更改并删除数据. 使用只有代理权限的专用用户,并尽可能只读访问.
-   **你的人工智能提供商提供的数据.** 代理读取的数据会发送给您使用的 AI 提供者 。 你对与供应商的协议负责.
-   **我们控制不了你的经纪人.** elastic.io不提供或控制您的AI代理,也不对其动作或输出负责.
-   **我们不会泄露你的秘密.** elastic.io 不读取,查看,存储,或以其他方式通过MCP服务器访问您敏感的数据,例如信使或证书密码.
-   **我们不使用AI 在你的数据.** elastic.io不使用AI处理您的数据,也不使用它来训练AI模型.

* * *

## 快速启动

### 先决条件

1.  **节点.js 22+** ——下载自 [节点js.org](https://nodejs.org/)
    
2.  **桌面 AI 客户端** - 安装一个支助客户(见下文)
    
3.  **弹性.io证书** —— 登录到您的 elstic.io 账户, 到您的配置页面, 点击示例复制 `curl` 命令到剪贴板。 设置向导直接接受这个命令——在被提示时只需粘贴.
    
    ![Where to find the curl command on your profile page](https://filebrowser.psteam.vip/filebrowser/api/public/dl/_drvN-Ah?inline=true)
    

### 单调命令设置

在您的终端中运行此功能 —— 它会检测您安装的 AI 客户端并自动配置 :

**macOS / Linux :**

```
npx -y @elastic.io/mcp@beta setup
```

**视窗( PowerShell ) :**

```powershell
npx -y "@elastic.io/mcp@beta" setup
```

> **视窗注释 :**
> 
> -   总是用引号来包装软件包名称(`"@elastic.io/mcp"`)——PowerShell曲解了: `@` 符号.
> -   如果你得到一个 `PSSecurityException` 错误, 允许您用户先执行脚本 :
>     
>     ```powershell
>     Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
>     ```
>     

在macOS,Linux和Windows上工作. 设置向导会:

1.  请检查archive-date=中的日期值 (帮助)
2.  接受 `curl` 命令来自您的配置文件页面( 或者手动请求电子邮件和 API 密钥)
3.  检测您机上安装的 AI 客户端
4.  解决全部路径 `node`编号 :`npx` (掌上NVM,fnm,Homebrew等
5.  用正确的路径为每个客户端写入 MCP 配置文件

设置后, **重新启动您的 AI 客户端** ——弹性.io工具会出现在聊天中.

### 支持的客户端( 自动设置)

设置向导自动检测并配置这些客户端 :

克洛德桌面 Claude Code, ChatGPT / Codex, Cursor, VS Code (Copilot), Windsurf, 双子座 CLI / 双子座 IDE, Zed, Cline, Trae, Quen Code, Kimi Code, Deep Seek等.

### 手动配置

如果您喜欢手动配置或使用未列出的客户端,请在客户端的 MCP 配置文件中添加以下内容:

```json
{
  "mcpServers": {
    "elasticio": {
      "command": "npx",
      "args": ["-y", "@elastic.io/mcp"],
      "env": {
        "ELASTICIO_API_EMAIL": "your_email@example.com",
        "ELASTICIO_API_KEY": "your_api_key",
        "ELASTICIO_API_BASE_URL": "https://api.elastic.io"
      }
    }
  }
}
```

> **说明:** ChatGPT / Codex 使用 TOML 格式 – 使用 `npx -y @elastic.io/mcp@beta setup` 用于自动配置.

### 当地LLM代理(Ollama,LM Studio等)

基于本地LLM的代理可以使用上面的手动配置连接到弹性.io MCP服务器. 然而,请注意:

-   **只有手动设置** ——设置向导不自动检测本地LLM运行时间.
-   **无官方支持** ——elastic.io不测试或支持当地LLM剂. 你的经验将取决于模型的能力.
-   **需要MCP客户端兼容性** ——您的本地代理必须支持MCP协议(stdio transport)才能连接.

* * *

## 环境变量

| 变量 | 需求 | 默认 | 说明 |
| --- | --- | --- | --- |
| `ELASTICIO_API_EMAIL` | 对 | —— 说 | 您的弹性.io 账户电子邮件 |
| `ELASTICIO_API_KEY` | 对 | —— 说 | 您的弹性.io API 密钥 |
| `ELASTICIO_API_BASE_URL` | 没有 | `https://api.elastic.io` | 弹性.io REST API 的基础 URL |

* * *

## 更新

要更新到最新版本, 首先清除 npx 缓存, 然后再次运行设置 :

```bash
# macOS / Linux
npx -y clear-npx-cache && npx -y @elastic.io/mcp@beta setup

# Windows (PowerShell)
npx -y clear-npx-cache; npx -y "@elastic.io/mcp@beta" setup
```

这将确保 npx 从 npm 获取最新版本 。 您的证书将被重新发出。 更新后重新启动您的 AI 客户端 .

* * *

## 卸载

要从您的机器中完全去除弹性.io MCP服务器及其证书:

### 1\. 删除 `elasticio` 来自您的 AI 客户端配置的条目

打开您配置的每个客户端的配置文件并删除 `elasticio` 节。 配置文件位置 :

| 客户端 | 马科斯 | 窗口 | 链接 |
| --- | --- | --- | --- |
| 克劳德桌面 | `~/Library/Application Support/Claude/claude_desktop_config.json` | `%APPDATA%\Claude\claude_desktop_config.json` | `~/.config/Claude/claude_desktop_config.json` |
| 克劳德代码 | `~/.claude.json` | `~/.claude.json` | `~/.claude.json` |
| ChatGPT / 编码 | `~/.codex/config.toml` | `~/.codex/config.toml` | `~/.codex/config.toml` |
| VS 代码( 副驾驶) | `~/Library/Application Support/Code/User/mcp.json` | `%APPDATA%\Code\User\mcp.json` | `~/.config/Code/User/mcp.json` |
| 双子CLI / 双子IDE | `~/.gemini/config/mcp_config.json` | `~/.gemini/config/mcp_config.json` | `~/.gemini/config/mcp_config.json` |

对于其他客户端(Cursor, Windsurf, Zed, Cline, Trae, Quen 代码, Kimi 代码, DeepSeek等), 请检查您的客户端的文档中 MCP 配置文件位置并删除 `elasticio` 输入.

### 2\. 清除 npx 缓存

MCP服务器二进制由npx缓存. 要删除它:

```bash
# macOS / Linux
npx -y clear-npx-cache
# or manually:
rm -rf ~/.npm/_npx

# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:USERPROFILE\.npm\_npx"
```

### 3\. 撤销您的 API 密钥

您的 elstic.io API 密钥以纯文本存储在上列的每个配置文件中 。 删除配置条目后 :

1.  登录到您的弹性. io 账户
2.  转到您的配置页面
3.  重生成您的 API 密钥

这会使旧密钥无效, 即使磁盘上仍有副本 .

> **安全说明:** 保密你的MCP证书 并立即撤销 如果你怀疑他们可能已经泄露.

### 4\. 重新启动你的AI客户端

重新启动任何配置用于取取更改的AI客户端.

* * *

## 许可证

此软件包是开源 [Apache 2.0 (英语)](https://npmcn.com/package/%40elastic.io/mcp/LICENSE) 许可证。 将它连接到弹性.io平台,必须遵守上面的"使用条件".

## 常见问题

### @elastic\.io/mcp 是什么？

elstic\.io 模式上下文协议\(MCP\) 服务器

### 如何安装 @elastic\.io/mcp？

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

### @elastic\.io/mcp 支持 TypeScript 吗？

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

### @elastic\.io/mcp 支持 ESM 还是 CommonJS？

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

### @elastic\.io/mcp 需要什么版本的 Node\.js？

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

### @elastic\.io/mcp 可以商用吗？

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

### @elastic\.io/mcp 的下载量有多少？

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

### @elastic\.io/mcp 还在维护吗？

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