# @equationalapplications/mcp-server 中文文档

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

版本：8\.4\.0
npm 元数据更新时间：2026-11-12T22:20:00.319Z
中文译文更新时间：2026-11-13T21:35:31.944Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40equationalapplications/mcp-server
原文对照：https://npmcn.com/package/%40equationalapplications/mcp-server/?lang=original
项目主页：https://equationalapplications.github.io/expo-llm-wiki/packages/mcp-server/
源码仓库：https://github.com/equationalapplications/expo-llm-wiki

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

- 包体积（解压后）：1.9 MB，14 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-11-02T16:33:54.233Z
- 最新版本发布：2026-11-12T22:19:59.983Z
- 近 30 天下载量：3040（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

给编码代理(Claude Code, Cursor, Windsurf, Claude Desktop)一个突触Tree内存的MCP服务器:搜索,记忆,替换,摄入,记录事件,并穿越知识图.

## 安装

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

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

## README

# @ 公式应用程序/ mcp- server

代码代理的突触Tree内存: 允许 Claude Code, Cursor, Windsurf, Claude Desktop 或任何 MCP 客户端搜索的 MCP 服务器, 记住、 取代、 吞噬、 记录事件, 并在您中行走知识图 [突触主题](https://synapsetree.dev/) 数据库.

[![npm version](https://img.shields.io/npm/v/%40equationalapplications%2Fmcp-server?label=mcp-server)](https://www.npmjs.com/package/@equationalapplications/mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/mcp-server/LICENSE)

**[医生](https://equationalapplications.github.io/expo-llm-wiki/)** • 妇女 **[GitHub 图像](https://github.com/equationalapplications/expo-llm-wiki)** • 妇女 **[范围Lab](https://equationalapplications.github.io/expo-llm-wiki/scopelab/)** • 妇女 **[维基解密](https://equationalapplications.github.io/expo-llm-wiki/wiki-demo/)** • 妇女 **[更改日志](https://github.com/equationalapplications/expo-llm-wiki/blob/main/CHANGELOG.md)** • 妇女 **[问题](https://github.com/equationalapplications/expo-llm-wiki/issues)**

## 这是什么

一个小节点程序 您的MCP客户端在您自己的机器上 发射在stdio。 它暴露出8个SynapseTree内存操作作为工具,并转发每个调用到 `https://api.synapsetree.dev` 用您的 API 键。 它只存储了那个密钥,一个基础URL,和一个默认的命名空间. 它从不运行在任何人的云中,它从不看到你与模型的对话——只有工具呼叫.

## 安装

```bash
npm install -g @equationalapplications/mcp-server
```

节点20或更新. 安装了一个命令 : `synapsetree-mcp`。 。 。 .

从源头运行:

```bash
git clone https://github.com/equationalapplications/expo-llm-wiki && cd expo-llm-wiki
pnpm install && pnpm --filter @equationalapplications/mcp-server build
cd packages/mcp-server && pnpm link --global   # puts synapsetree-mcp on PATH
```

## 拿个钥匙

**从仪表盘起.** 签名于 [https://synapsetree.dev/dashboard 页面存档备份,存于互联网档案馆](https://synapsetree.dev/dashboard)打开 _API 密钥_,然后在数据库旁边发布一个密钥:

```bash
synapsetree-mcp auth --key stree_…
```

这个 `--key` 窗体将这个秘密放在您的外壳历史和进程列表中。 改为: 都别管 默读 然后为会议导出

```bash
read -rs SYNAPSETREE_API_KEY && export SYNAPSETREE_API_KEY
```

`synapsetree-mcp status` 捡起它 `auth --revoke` 还行.

**通过电子邮件,从终端** (单位:千美元) [auth.md 数据](https://synapsetree.dev/auth.md) 流线 :

```bash
synapsetree-mcp auth --email you@example.com
```

六位数代码被打印出. SynapseTree在大约一分钟内将一个批准链接电子邮件给您;页面显示的是相同的代码. 只有在代码匹配时才能批准. 链接在15分钟后到期. 批准后的首个民意调查收到唯一的密钥副本并存储.

密钥存储于 `credentials.json` 以模式配置目录 `0600` 绝不然; `status` 显示最后四个字符.

## 设置命名空间

每个内存工具都需要命名空间. 每台机器设定默认一次, 或者通过 `namespace` 每个电话:

```bash
synapsetree-mcp config set namespace repo:myproject
```

公约: `repo:<directory name>`。服务器从不创建命名空间.

## 连接客户端

克劳德代码 :

```bash
claude mcp add synapsetree -- synapsetree-mcp
```

光标( C)`.cursor/mcp.json`),"风行"(Windsurf)`~/.codeium/windsurf/mcp_config.json`),克洛德桌面(英语:`claude_desktop_config.json`:

```json
{ "mcpServers": { "synapsetree": { "command": "synapsetree-mcp" } } }
```

## 工具

| 工具 | 它会做什么 |
| --- | --- |
| `memory_search` | 对事实的混合搜索;以及返回尚待完成的任务和最近的事件。 在账户所有者注册嵌入提供者之前,只使用关键字( E)`diagnostics.keyword_only`) (中文(简体) ). |
| `memory_remember` | 存储一个事实(标题,身体,标记,自信,类型). 与无供养. |
| `memory_supersede` | 用一个更正的事实取而代之;历史保留。 从不删. |
| `memory_ingest` | 存储整个文档,让SynapseTree提取事实. 需要一个在仪表板(BYOK)上注册的提取提供者. |
| `memory_log_event` | 记录一项意见、决定、行动或结果. |
| `graph_traverse` | 将知识图从一个事实或节点走出,可达3个跳. |
| `namespaces_list` | 列表命名空间,可选用前缀. |
| `whoami` | 账户,数据库,范围,计划,订阅状态. |

## 环境变量

| 变量 | 效果 |
| --- | --- |
| `SYNAPSETREE_API_KEY` | 使用此密钥代替所存储的密钥 . |
| `SYNAPSETREE_BASE_URL` | API 基础 URL( 默认) `https://api.synapsetree.dev`) (中文(简体) ). |
| `SYNAPSETREE_NAMESPACE` | 默认命名空间, 覆盖 `config.json`。 。 。 . |
| `SYNAPSETREE_CONFIG_DIR` | 何处 `credentials.json` 财务报告和审定财务报表 `config.json` 活着. |

默认配置目录: macOS `~/Library/Application Support/synapsetree`时, Linux `$XDG_CONFIG_HOME/synapsetree` 或者说 `~/.config/synapsetree`窗口 `%APPDATA%\synapsetree`窗口上 `0600`编号 :`0700` 文件模式是最佳的.

## 它从来没有做什么

-   导出、删除或运行内存维护 。 这些是仪表盘上的所有者的行为,即使你的密钥可以,这个服务器也不会曝光它们.
-   打印您的密钥, 或电子邮件注册时使用的索赔令牌 .
-   除了你的机器,到处跑 记忆只到 SynapseTree; SynapseTree 调用推论提供者,只有当账户所有者注册一个.

## 校验

```bash
synapsetree-mcp status
npx @modelcontextprotocol/inspector synapsetree-mcp
```

## 发布清单(维护者)

在发布一个版本之前, 运行整个序列对齐突触Tree **测试** 带有仪表盘密钥和孤立的配置目录,所以没有 步骤可以触摸您的真实资格:

```bash
unset SYNAPSETREE_API_KEY                            # an inherited key would take
                                                     # precedence over the isolated
                                                     # credentials file below
export SYNAPSETREE_BASE_URL=https://test-stage…      # the test stage, for EVERY step below
export SYNAPSETREE_CONFIG_DIR=$(mktemp -d)           # isolated credentials
export SYNAPSETREE_LIVE_TESTS=1                      # opts the live chain into `pnpm test`
cd "$(git rev-parse --show-toplevel)"                 # back to the repo root: all paths below are repo-root paths
CLI="$(pwd)/packages/mcp-server/dist/cli.js"    # the CLI built from this checkout, not a global install
pnpm build
```

1.  `node "$CLI" auth --key …` 接下来 `node "$CLI" status`。 。 。 .
2.  `SYNAPSETREE_API_KEY=… pnpm --filter @equationalapplications/mcp-server test` 运行活链(`whoami` ——记住——搜索——取代——搜索——日志事件——列表。 除非 `SYNAPSETREE_LIVE_TESTS=1` 已经设定.
3.  `npx @modelcontextprotocol/inspector node "$CLI" serve` 运行一个 `memory_search`。 。 。 .
4.  `node "$CLI" auth --email …` 一次,批准电子邮件,然后 `node "$CLI" auth --revoke`。 。 。 .

销售商合同 `contract/` 在 SynapseTree 寄存器中生成,并且不能进行手动编辑;如果从工具发送的内容中漂移,或者如果其中包含只包含所有者操作,则单元测试失败.

## 莫诺雷波生态系统

| 软件包 | 目的 |
| --- | --- |
| [@ 方程式应用程序/ core-llm-wiki](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core/README.md) | 持续的零星记忆 |
| [@ 方程式应用程序/ expo- llm- wiki](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/expo/README.md) | 世博会/反应原生器的持久性瞬间记忆 |
| [@ 方程式应用/ react-llm-wiki](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/react/README.md) | Web 的持续的零星记忆 |
| [@equental applications/prisma-outbox (英语)](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/prisma-outbox/README.md) | 同步 SQLite 发件箱事件到 Prisma |
| [@ 方程式应用程序/ 核心工具](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core-llm-tools/README.md) | 双子座工具计划和能力注射器 |
| [@ 方程式应用程序/ core-okf](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/okf/README.md) | 零依赖开放知识格式 (OKF) v0.1 + v0.2 原始人——剖析并生成可互通的知识捆. |
| [@equationalapplications/schema-org-llm-wiki (英语)](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/schema-org/README.md) | Cured schema.org 温剂肿瘤特征表 |
| [@equental应用程序/schema-software-org](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/schema-software-org/README.md) | 软件组织执行本体学表——17个节点类型,40个边缘,热剂超集,只数据 |
| [**@ 公式应用程序/ mcp- server**](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/mcp-server/README.md) | MCP 服务器向编码代理显示 SynapseTree 内存工具 |

* * *

由方程式应用有限责任公司制造. [https://equationalapplications.com/ (中文(简体) )](https://equationalapplications.com/)

## 常见问题

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

给编码代理\(Claude Code, Cursor, Windsurf, Claude Desktop\)一个突触Tree内存的MCP服务器:搜索,记忆,替换,摄入,记录事件,并穿越知识图\.

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

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

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

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

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

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

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

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

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

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

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

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

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

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