# @contextstream/mcp-server 中文文档

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

版本：1\.0\.49
npm 元数据更新时间：2026-10-31T19:49:07.782Z
中文译文更新时间：2026-10-31T21:01:40.374Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40contextstream/mcp-server
原文对照：https://npmcn.com/package/%40contextstream/mcp-server/?lang=original
项目主页：https://contextstream.io/lp/mcp-marketplace?utm_source=npm&utm_medium=directory&utm_campaign=mcp_organic_2026q3&utm_content=card_cta
源码仓库：https://github.com/contextstream/mcp-server

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

- 包体积（解压后）：174 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2025-11-30T06:41:47.797Z
- 最新版本发布：2026-10-31T19:49:07.589Z
- 已发布版本数：199（近 12 个月 199 个）

## 中文简介

验证了开源ContextStream Rust MCP服务器的npm启动器

## 安装

```sh
npm install @contextstream/mcp-server
```

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

## README

![ContextStream](https://npmcn.com/package/%40contextstream/mcp-server/assets/contextstream-logo.png)

# ContextStream MCP服务器

**人工智能代理的上下文平台。**

## 你的代理知道代码。把你的决定交给它。

连接您的代码、文档和对话，以便您的代理可以找到正确的 文件，召回保存的决策，并跨会话和工具构建过去的工作。

[![ContextStream benchmarks: LongMemEval-S 96.8% (484 of 500), LoCoMo 95.7%, code search 98.77% best answer in the top 10, agent tasks 96% (23 of 24, up from 58% without it)](https://raw.githubusercontent.com/contextstream/mcp-server/main/assets/benchmarks-light.png)](https://contextstream.io/benchmarks)

这些数字，他们的来源，以及他们没有声称的是 [基准](https://npmcn.com/package/%40contextstream/mcp-server/#readme-benchmarks).

## 免费开始使用MCP

**每月10000个积分。不需要信用卡。**

可与Claude Code， Cursor, Codex, GitHub Copilot, Gemini CLI, Qwen Code， Kimi Code, Muse Code, ZCode, Zed，还有 [更多MCP客户端](https://npmcn.com/package/%40contextstream/mcp-server/docs/clients.md),在 Claude、GPT、Gemini、Kimi、GLM、Qwen等车型。 在MCP登录期间创建您的帐户或登录。不需要单独的网站注册。

**macOS和Linux**

```sh
curl -fsSL https://contextstream.io/scripts/mcp.sh | bash
```

**Windows PowerShell**

```powershell
irm https://contextstream.io/scripts/mcp.ps1 | iex
```

将该命令粘贴到您的终端中，并按照登录操作连接您的 项目和支持的编辑器。安装完成后重新启动编辑器。

[什么会被安装和索引？](https://npmcn.com/package/%40contextstream/mcp-server/docs/data-handling.md) · [支持客户](https://npmcn.com/package/%40contextstream/mcp-server/docs/clients.md) · [安装指南](https://contextstream.io/docs/editors/setup) · [更喜欢从网上开始？](https://contextstream.io/lp/mcp-marketplace?utm_source=github&utm_medium=directory&utm_campaign=mcp_organic_2026q3&utm_content=card_cta)

## 让下一个会话有用

询问您连接的代理：

> 使用ContextStream查找与我的下一个更改相关的文件。引用 来源并检索任何保存的项目决策，这些决策应该指导工作。

然后要求它保存一个真正的决定和它的原因。开始一个新的会话 收回那个决定，不要再解释。索引供应代码 上下文;它不能恢复每一个未记录的决策。

## 基准

每个基准测试通过生产API运行，在其结果之前注册 被读取，并连同其方法、置信区间和损失一起发布。

| 基准 | ContextStream | 相比之下, |
| --- | --- | --- |
| **LongMemEval-S**，全部500道题 | **96.8%** (484/500);96.0%的人坚持不调弦 | 高于大师（94.87%）和超级记忆（85.4%）在同一个官方gpt - 40裁判上。与agentmemory自我报告的96.2%持平，这在我们的95%区间内 |
| **LoCoMo**，全部1540道题 | **95.7%** (1474/1540);95.8%的人坚持；97.8%的人对审计的答案关键 | 在EverMemOS论文的相同判断表中，每个系统之上：EverMemOS 93.05%, Zep 85.22%, MemOS 80.76%, MemU 66.67%, Mem0 64.20% |
| **代码搜索**， 177个判断的开发者查询 | **98.77%** 前十名中最佳答案； **100％** 一个有用的文件在前10名 | 在相同的查询和判断中，仅嵌入搜索占72.84%，ripgrep占42.59% |
| **代理任务**， 8个任务× 3个试验 | **23/24** 通过(96%);9/9的任务需要团队知识 | 14/24（58%）和0/9单独使用存储库 |

**服务器端搜索时间中值为61毫秒** （127 ms p95）在10月27日的生产 运行。端到端时间为223毫秒，因为客户端运行在与服务器不同的区域 一个服务于工作空间。您的延迟取决于您与该区域的距离。

竞争对手的数据是每个供应商或EverMemOS论文发表的数据；我们做了 而不是重播，读者和评委的意见不同。代码搜索基线 来自8月1日运行的相同查询。代理任务结果使用一个 存储库和一个代理模型，因此将其视为定向的。 [结果、方法和局限性](https://contextstream.io/benchmarks).

## ContextStudio

对于人们来说，ContextStream Create提供了一键制作，服务器添加了一个工具， `studio`：要求一段影片，一段从你的联网产品拍摄的产品解说，以及 图像、声音或音乐用简单的语言表达出来，而ContextStudio的制作人则计划将这些片段从 你的团队知道什么（品牌工具包、文档、决策、相关产品）。没有模型 选择。

-   **品牌工作的名字。** 品牌形象(社交集在每个网络的大小，广告集，英雄 和产品照片，海报和传单打印pdf文件，电子邮件标题，品牌图形)和 品牌声音（声音标志，音乐床，循环，效果包，画外音，播客介绍） 和outros)：通过 `form`, `sizes` (最多6个，如 `instagram-post` 或者 `linkedin-post`)或 `voice`，而计划则坚持下去。
-   **先计划，再定价。** `plan` 返回碎片和一个价格(“最多N个积分，可能 ”)，什么也不花。传递您的代理知道的工作空间可能不 如果它刚刚制作，发布说明，它已经打开的文档) `context`;制作人读到 它紧挨着团队自身的环境。
-   **你的批准。** `make` 最多花计划的价格，只有在你同意后 客户端可以要求您（MCP引出），或者是无状态的 `input_required` 结果)问 你本身;否则，代理会按你接受的价格支付。
-   **跟随它。** `status` 在等待时报告每个片段 `notifications/progress` 在电话要求他们的地方)；一部产品胶片需要13到21分钟 分钟。 `result` 显示内联图像和链接视频和声音(签名链接有效 大约15分钟)，每个作品的标语牌。品牌工作就像文件一样，每个文件都有自己的特点 自己的链接：每一个大小为PNG， JPG和WebP与ZIP的集合，打印PDF，或WAV和 MP3的网络与广播主和茎，加上所有的文本，一个标题和 支票被扣住了。
-   **修改。** `revise` 从一个制作好的图像或声音开始 `variation` （更像是） `revision` （它，如你所说的改变了）或者 `resize` (一个新的图像 `sizes`）. 也 `stop`， `library`， `brand` 和 `products`.
-   **电子邮件，这是Create提供的服务。** 通过您的团队自己的Resend帐户发送的活动。 `email_draft` 在你的品牌上写一个提示（“宣布我们的冬季促销给……”） 客户”)，什么也不发； `email_audiences`， `email_campaigns`， `email_test` (你的 自己的地址或重新发送的测试地址)， `email_cancel` 和 `email_report` (活动的 交付、打开、点击、跳出和投诉，或者工作空间的趋势)。 `email_send` 只随你的意思走：客户问你什么时候可以；否则，代理会向您展示 活动及其接收者计数并通过您同意的计数。 `email_preview` 提供了一个共享链接，显示bgmail， Outlook和Apple Mail中的电子邮件 模型（桌面，平板电脑和手机，明暗，图像打开或关闭），与收件箱线 检查什么。 `email_revise` 从简单的词（“较短的主题”）或 设置主题和预览线； `email_duplicate` 做一份草稿。 `email_contacts` 列出、添加（加上他们同意收到你来信的地方）或取消订阅联系人；擦除一个 不能撤消，所以它是 `delete` 工具(`studio.email_contact_erase`)，你走后； `email_unsubscribes` 显示抑制列表以及原因和时间，并删除一个地址 它只随你去。Resend是在工作室中连接的，而不是通过代理：工具 拒绝任何形状像重发键的东西。
-   **连接器。** 托管路径 `/studio` 只服务于这个工具，为克劳德。ai或ChatGPT 连接器，将OAuth令牌绑定到该资源(`read:studio`， `write:studio`）。

## 数据控制

**作用域的访问。可追踪的来源。可配置的捕捉。** 索引将符合条件的源内容发送到ContextStream进行托管搜索。 默认情况下，脚本保存和本地Git元数据捕获是开启的 关闭。审查 [数据处理和控制](https://npmcn.com/package/%40contextstream/mcp-server/docs/data-handling.md) 之前 连接敏感项目。

**其他安装选项和故障排除**

### npm （Node.js 20+）

```bash
npx -y @contextstream/mcp-server@latest setup
```

npm启动器为你的平台下载原生Rust二进制文件并进行验证 其SHA-256校验和。为生产自动化固定一个精确的包版本。

### 没有本地进程的托管MCP

对于支持可流HTTP和OAuth的客户端，托管端点为：

```text
https://mcp.contextstream.io/mcp?default_context_mode=fast
```

[支持客户](https://npmcn.com/package/%40contextstream/mcp-server/docs/clients.md) 列出了Claude的一行添加命令 Code, Codex, Gemini CLI, Qwen Code, Copilot CLI，和Droid，一键式 安装VS Code。使用 [MCP文档](https://contextstream.io/docs/mcp) 对于其他客户和工作室的选择。单独的托管连接不需要 同步本地结帐。

### 预览或诊断设置

```bash
contextstream-mcp setup --dry-run
contextstream-mcp doctor
contextstream-mcp doctor --repair
```

### 脚本化和CI设置

对于自动化，将安装封装在 `pipefail` 所以下载时失败了 失败，而不是在没有安装后报告成功：

```bash
bash -o pipefail -c 'curl -fsSL https://contextstream.io/scripts/mcp.sh | bash'
```

`setup --yes` 从 `CONTEXTSTREAM_API_KEY` 或者保存凭据， 和需要 `--workspace-id` 当帐户有多个工作区时：

```bash
export CONTEXTSTREAM_API_KEY=...   # or: printf %s "$KEY" | contextstream-mcp configure --api-key-stdin
contextstream-mcp setup --yes --editors=claude --workspace-id=<UUID> --project-path=.
```

### 包裹Bouncer（可选择加入）

一个用于Claude Code和Cursor的钩子，用于检查包和安装命令名 在命令运行之前对其公共注册表。它涵盖了npm， pnpm, yarn, bun， Npx, pip, uv, uvx, pipx，诗歌和货物，包括 `claude mcp add ... -- npx ...`.

-   它 **否认** 注册表没有的包，将其命名为流行的包 的样子。代理人可能发明了这个名字，任何人都可以注册。
-   它 **问** 在一个几乎没有下载的流行软件包之前。
-   它 **允许** 其他所有内容，包括查找失败或耗时过长。

它会跳过使用私有注册表的项目和命令(`.npmrc`， `pip.conf`， uv或 诗歌的来源, `--registry`， `--index-url`）。 `CONTEXTSTREAM_PACKAGE_BOUNCER=off` 关掉它。

克劳德代码：将此条目添加到 `PreToolUse` 在 `~/.claude/settings.json`，在…旁边 挂钩安装完毕。 `update-hooks` 别管它。

```json
{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "contextstream-mcp hook package-bouncer", "timeout": 8 }] }
```

光标(`~/.cursor/hooks.json`):

```json
{ "version": 1, "hooks": { "beforeShellExecution": [{ "command": "contextstream-mcp hook package-bouncer" }] } }
```

## 开源和贡献

此存储库包含麻省理工学院许可的Rust MCP服务器，客户端，编辑器设置， 以及发布工具。托管后端是独立的，这里不包括。 看到 [体系结构](https://npmcn.com/package/%40contextstream/mcp-server/docs/architecture.md)， [释放的完整性](https://npmcn.com/package/%40contextstream/mcp-server/docs/release.md)， 和 [最新版本](https://github.com/contextstream/mcp-server/releases/latest).

```bash
cargo build --locked -p mcp-server --bin contextstream-mcp
cargo test --locked --workspace
```

使用固定的Rust工具链。有关贡献检查和提交签名，请阅读 [CONTRIBUTING.md](https://npmcn.com/package/%40contextstream/mcp-server/CONTRIBUTING.md)． 使用以下命令报告漏洞 [SECURITY.md](https://npmcn.com/package/%40contextstream/mcp-server/SECURITY.md)． 看到 [许可证](https://npmcn.com/package/%40contextstream/mcp-server/LICENSE)， [请注意](https://npmcn.com/package/%40contextstream/mcp-server/NOTICE), [GOVERNANCE.md](https://npmcn.com/package/%40contextstream/mcp-server/GOVERNANCE.md) 用于许可、商标和项目治理。

* * *

**让人类成为人类。**

[文档](https://contextstream.io/docs/mcp) · [定价](https://contextstream.io/pricing) · [集成](https://contextstream.io/docs/integrations) · [基准](https://contextstream.io/benchmarks)

### 可选的深度项目学习

深度项目学习从新客户开始。互动 `setup` 提供它 每个账户一次（或条款改变时一次），如果你拒绝，记得；平原 `contextstream-mcp setup --yes` 保留您当前的选择。

```bash
contextstream-mcp configure --account-learning status   # show current consent state
contextstream-mcp configure --account-learning on       # open privacy page in browser (or print URL)
contextstream-mcp configure --account-learning off      # withdraw consent and queue deletion
```

`--deep-learning` 的别名 `--account-learning`． 只是一个人 可以通过勾选登录隐私页面上的未选中框来授予同意吗 （`https://contextstream.io/dashboard/account/privacy`）; 代理和API密钥不能 我替你同意。医生和init只显示状态。看到 [数据处理和控制](https://npmcn.com/package/%40contextstream/mcp-server/docs/data-handling.md).

## 常见问题

### @contextstream/mcp-server 是什么？

验证了开源ContextStream Rust MCP服务器的npm启动器

### 如何安装 @contextstream/mcp-server？

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

### @contextstream/mcp-server 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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