EleSync

MCP文档知识

提供方 未标注

文档知识 未标注 未标注 社区 / 第三方 ClaudeCursorVS CodeWindsurf

隐私优先的本地记忆库,所有AI通过MCP共享。Markdown + SQLite 运行在你的设备上;Claude、ChatGPT、Cursor 及任何MCP客户端均可实时读写。无云端、无账户、无遥测。

一句话选型结论

按资料字段整理

EleSync 属于文档知识类 MCP 服务器,传输方式未标注,鉴权方式未标注,可直接接入 Claude、Cursor、VS Code 等,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式未标注 鉴权未标注 部署方式未标注
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

记忆

安装与配置

未标注 未标注
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude、Cursor、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
EleSync当前 未标注 未标注 未标注 无 未标注
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方未标注上游标注的维护方 未标注
分类文档知识本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

10.6 KB
来自项目仓库与上游目录的原文,未做删改

EleSync

Your private AI workspace

EleSync gives you a private workspace that your AI tools can share.

When every AI assistant keeps a separate history, you repeat the same background,
preferences, decisions, and project details over and over. EleSync keeps the durable
context you choose in a local vault, then lets approved assistants use that context
with explicit project and scope boundaries.

Start a project with one assistant, continue it with another, and keep the context in
a folder you control.```text
Your local vault
↓
Memories and imported history
↓
Projects, knowledge, tasks, decisions, and handoffs
↓
Approved AI assistants


No EleSync account, hosted cloud database, e-mail registration, telemetry, subscription,
or mandatory cloud sync is required.

## The five-minute path

A new user should be able to go from installation to a useful AI workspace like this:

1. **Choose a vault.** Pick the local folder where EleSync will keep your workspace.
2. **Protect access.** Add a local dashboard username and password when you need remote
   or shared-device access.
3. **Import AI history.** Bring in ChatGPT, Claude, Gemini, WhatsApp, or other supported
   exports and review what will become durable context.
4. **Create a project.** Give your memories a purpose and a boundary.
5. **Connect an assistant.** Connect Claude Desktop locally, or use a secure HTTPS/OAuth
   flow for a remote assistant such as ChatGPT, Gemini, or Grok.
6. **Test recall.** Ask your assistant: `What useful context can you retrieve from EleSync?`

The dashboard includes a guided first-launch wizard and progress tracking for these steps.

## What EleSync does

- **Memory:** gives assistants continuity across conversations and providers.
- **Projects:** give context purpose, organization, and boundaries.
- **Knowledge:** stores reusable knowledge sheets, tasks, decisions, and handoffs.
- **MCP/connectors:** let approved AI assistants participate in the workspace.
- **Imports:** bring existing AI history, documents, and WhatsApp conversations into one place.
- **PWA/mobile:** capture and access the workspace from a phone while your computer runs EleSync.
- **Privacy:** keeps the vault local-first and makes sharing explicit.

Important: when you connect an AI assistant, that assistant may read the context you make
available to it. Use project boundaries, scopes, read-only permissions, and separate vaults
when you need stronger limits.

## Visual tour

The dashboard is the center of the workspace: memories, projects, imports, connection health,
and mobile access are all reached from one place.

The product workflow is:

| Area | What you use it for |
| --- | --- |
| **Import** | Upload ChatGPT, Claude, Gemini, WhatsApp, JSON, CSV, Markdown, TXT, or ZIP exports. |
| **Memories** | Search, review, edit, and organize imported and saved context. |
| **Projects** | Collect memories, knowledge sheets, tasks, decisions, and handoffs. |
| **Connect AI** | Configure local Claude Desktop or secure remote AI connections. |
| **Connection Health** | See whether the vault, dashboard security, local clients, and remote setup are ready. |
| **PWA/mobile** | Capture text, links, and imports from a phone. |

## Privacy by design

- **Local-first:** notes and the search index live in the vault on your computer.
- **User-controlled:** you choose the vault folder, backups, and what becomes durable.
- **No mandatory cloud account:** normal local use works without an EleSync cloud service.
- **Optional encryption:** encrypted vaults use Argon2id and XSalsa20-Poly1305 at rest;
  plaintext remains the default for portability.
- **Scoped AI access:** client grants can limit which memory scopes an assistant can read or write.
- **Project isolation:** project-bound connections cannot recall or modify memories outside their project.
- **Reviewable imports:** imported conversations and WhatsApp messages can be reviewed before saving.

## Install

Install EleSync from PyPI or use the standalone Windows and Linux downloads.

### Python / pip

Requires Python 3.11 or newer. Once the release is published to PyPI:```bash
python -m pip install --upgrade elesync
ele web

Use a virtual environment or pipx install elesync on systems with externally managed Python.
For a local MCP client, the installed elesync command starts the stdio server.
With uv, use uvx --from elesync elesync. The MCP Registry name is
io.github.darknodebros/elesync.

Windows: easiest path

When a Windows installer is available, download EleSync-Setup.exe from the
releases page, run it, and open EleSync.

The installer is not code-signed yet, so Windows SmartScreen may say "Windows protected
your PC". Choose More info, then Run anyway.

The installer asks where to keep the vault and visibly lists the AI assistants available
from Connect AI after installation:```text
ChatGPT · Claude · Gemini · Grok · Perplexity · Copilot · DeepSeek


Claude Desktop is the optional local connection that can be pre-wired during installation.
Remote assistants require your authorization and a secure HTTPS connection, so the installer
does not silently configure them.

### Linux x86-64

Download `EleSync-linux` from the latest release.
It is a standalone executable for Linux x86-64 with glibc 2.35 or newer (Ubuntu 22.04+, including compatible distributions).
No Python installation is required. ARM64 and musl-based distributions such as Alpine are not supported by this binary.```bash
chmod +x EleSync-linux
./EleSync-linux

The launcher opens the local dashboard in your browser. For terminal use, download ele-linux:```bash
chmod +x ele-linux
./ele-linux --version
./ele-linux web


Verify downloads against the release's `SHA256SUMS` before running them. For example, in a folder containing both Linux executables and `SHA256SUMS`:```bash
grep -E '  (ele-linux|EleSync-linux)$' SHA256SUMS | sha256sum --check

Standalone builds

Standalone Windows builds (the installer plus portable zips of the app and the ele command)
are attached to each release in the
repository, when available.

From source (Python)

For macOS, Linux, or users who prefer Python tooling, install from a clone of the
repository:```bash
git clone https://github.com/darknodebros/elesync.git
cd EleSync
pipx install .
ele web


Requires Python 3.11 or newer. You can also use `pip install .` inside the clone.

## First import

From the dashboard:

1. Open **Import**.
2. Choose a supported file or drop it into the import area.
3. Review the detected format and privacy information.
4. For WhatsApp, filter by sender and approve only the messages you want to keep.
5. Save the full conversation or selected durable memories.
6. Open **Memories** to search what was imported.

Supported formats include:```text
JSON · CSV · TXT · Markdown · ZIP · WhatsApp exports · Grok exports

Imports are local. Nothing becomes durable project knowledge until the user saves or approves it.

First project

Open Projects, create a project, and give it a short purpose such as:```text
Japan trip planning
Product launch
Biology assignment
EleSync workspace


Inside a project you can:

- Add existing memories
- Save knowledge sheets
- Track tasks
- Record decisions
- Leave AI handoffs
- Set AI read/write/conversation permissions
- Generate a project-specific local Claude connection

## First AI connection

### Claude Desktop: local project connection

From a project page, choose the Claude provider and select **Generate project connection**.
EleSync creates a command like:```powershell
ele --vault "D:\notes" onboard --target claude-desktop --project PROJECT_ID --name elesync-project-a1b2c3d4

Run the command, restart Claude Desktop, and use the entry named:```text
elesync-project-a1b2c3d4


This entry is project-bound. Memories saved through it are attached to the selected project.
It can coexist with a general `elesync` entry; remove or disable the general entry when you
need strict project-only visibility.

### ChatGPT, Gemini, Grok, and other remote assistants

Remote assistants require a public HTTPS origin and provider authorization. Use the **Connect AI**
page to generate the current setup instructions. EleSync will show:

- MCP server URL
- Secure authentication details
- Local server command
- Tunnel/reverse-proxy target
- Connection verification result

Do not use `127.0.0.1`, a private LAN address, or the dashboard port as a public provider URL.

## Mobile companion (PWA)

EleSync can be installed on a phone without a separate mobile app:

1. Start EleSync on your computer with `ele web`.
2. Open **Use on another device** in the dashboard.
3. Put your phone and computer on the same Wi-Fi network.
4. Open the displayed address on your phone.
5. Choose **Add to Home Screen** or **Install app**.

The computer must be running for live vault access. The PWA supports shared text and link capture,
encrypted offline drafts, automatic retry, and mobile imports. Do not expose the dashboard publicly
without HTTPS and a passcode.

## Common commands```bash
ele web                         # open the local dashboard
ele doctor                      # check installation health
ele import memories.json        # import exported memories or notes
echo "I prefer dark mode" | ele import -
ele remember "Prefer short answers with examples"
ele recall "how should my AI answer me?"
ele sync                        # rebuild the local search index
ele summary                     # show a vault summary

Advanced commands cover encryption, backups, USB vaults, scopes, conflict resolution, HTTP serving,
and client wiring. See SETUP.md for the full walkthrough.

Troubleshooting

Run:bash ele doctor

Common fixes:

  • If the dashboard does not open, run ele web and copy the error.
  • If an AI assistant cannot see memories, restart it after setup.
  • If search looks stale, run ele sync.
  • If an import looks wrong, keep the original export and check its source format.
  • If a remote connector is rejected, verify HTTPS, the public /mcp URL, the tunnel target,
    and the authentication state in Connection Health.

Documentation

  • Setup guide
  • Architecture
  • Security policy
  • Release process
  • Changelog

Project status

EleSync is at 1.24.80 (1167 tests, ~12,500 LOC). The current product focus is stabilization:
bug fixing, UX polish, documentation, first-run completion, privacy clarity, and reliability.

License

EleSync is proprietary software.

Historical versions of EleSync that were previously released under the MIT License remain governed by the licenses attached to those specific releases. Current proprietary development does not revoke or alter rights already granted under those historical MIT releases.

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
EleSync 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

EleSync 怎么在 Claude、Cursor、VS Code 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

EleSync 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

EleSync 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

EleSync 支持哪些客户端?

资料标注支持 Claude、Cursor、VS Code、Windsurf、Gemini CLI、Codex;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

EleSync 能提供哪些能力?

资料显示能力标签包括 记忆。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。