Synapse MCP server
Commit Nov 9, 2026An agent-native API workbench that lets AI clients manage collections, environment variables, and execute requests via a shared SQLite database.
Also known as yanghuiwei/Synapse
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 9, 2026
- License
- MIT
What is Synapse MCP?
Synapse is an agent-native API workbench that lets AI clients manage collections, environment variables, and execute requests via a shared SQLite database.
Summary generated from the project's README
About Synapse MCP server
Managing API collections and executing requests through an AI agent is what Synapse enables. It serves as an agent-native workbench that bridges the gap between traditional API management and AI-driven workflows. By using a shared SQLite database, the desktop application and AI clients like Claude Code or Cursor stay perfectly synchronized, allowing an AI to create, modify, or execute requests that appear instantly in the desktop interface.
Developers can connect the MCP server to their preferred AI client by adding a specific configuration snippet to their settings. The server provides 13 specialized tools for browsing folders, managing environments, sending requests, and importing curl commands. It is designed for local-first use with no accounts or telemetry required, making it suitable for secure enterprise environments. Because it uses system root certificates and a lightweight 5.5 MB footprint, it integrates easily into local networks without complex dependencies.
What you can do with it
- 1Synchronized API managementWhen an AI creates a new request, it is immediately visible in the desktop application via the shared database.
Written from the project's README. Every use case is checked against a quote from it.
Configuration
REQLY_DB
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableyanghuiwei/synapse is public and reachablegithub.com/yanghuiwei/synapse ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/yanghuiwei/synapse ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubSynapse
Agent 原生的 API 工作台
单文件安装包 5.5 MB · 本地优先 · 无账号 · 无遥测
一、这是什么
Postman 很重、要登录、要云同步。更要命的是:它是给人点的,不是给 AI 调的。
Synapse 把两件事同时做干净:
| 管好日常 API 工作 | 集合、环境变量、Token 源、历史、压测、导入 —— 该有的都有 |
| 把同一份数据交给 AI | MCP Server 或 CLI,让 Claude Code / Cursor / WorkBuddy 自己找接口、改参数、发请求、看响应 |
关键在于同一份数据:桌面端和 AI 读写的是同一个 SQLite 文件。AI 建了一个请求,桌面端 1 秒内自己刷新出来 —— 不是把 curl 贴进对话框,是 AI 自己动手。
应用内不内置聊天框、不配 LLM provider。AI 从外面进来,Synapse 只负责干净的数据和干净的通道。
项目代号
reqly,产品名 Synapse。仓库里reqly-*是二进制与 crate 名,Synapse是用户看到的名字。
二、对比优势
对比同类
| Postman | Apifox | Insomnia | Synapse | |
|---|---|---|---|---|
| 安装包体积 | ~90 MB | ~120 MB | ~30 MB | 5.5 MB |
| 需要账号 | ✅ | ✅ | ❌ | ❌ |
| 云同步 / 遥测 | 默认开 | 默认开 | 可关 | 都没有 |
| AI 直接操作接口 | ❌ | 云端 Agent | MCP ✅ | MCP + CLI |
| 大响应体落文件 | — | — | ❌ | ✅(CLI) |
| 脚本 / 管道友好 | ❌ | ❌ | 部分 | ✅ --json | jq |
| 离线完全可用 | 部分 | ❌ | ✅ | ✅ |
| 开源 | ❌ | ❌ | ✅ | ✅ |
真正不一样的地方
① 体积不是压出来的,是架构决定的
reqly-mcp.exe 只读写一个 SQLite 文件,却曾因为 bin target 挂在桌面 crate 下而一路链上 Tauri —— 21.5 MB。拆成workspace 四个 crate 后降到 7.7 MB:
reqly 桌面端(tauri + 命令层)
├─ reqly-core 三入口共用的核心层 —— 不含 tauri / rmcp / axum
├─ reqly-mcp MCP Server(+ rmcp + axum) 7.7 MB
└─ reqly-cli 命令行(+ clap) 5.7 MB
再加 LTO + codegen-units=1 + strip + 静态链接 CRT。MCP 和 CLI 各带各的依赖,谁也不拖着谁。
② 依赖干净到能直接扔进内网
TLS 走 rustls + 系统根证书(不是 webpki 内置清单)。企业内网常见「用公司根证书做中间人代理」的网关 —— 换证书库这一下,就是能不能访问的区别。零 OpenSSL、零 SQLite 动态库、零 VC++ 可再发行包。
③ 外部改动自动同步
盯的是 SQLite 自己的 PRAGMA data_version 计数器,而不是文件 mtime(Windows 上精度到 15ms,连写两次只看见一次)。AI 在另一个进程改了库,桌面端 1 秒内刷新,不用重启。
④ 对外只给错误码,不给文案
28 个稳定错误码(E_TIMEOUT / E_DNS / E_TLS / E_DB_LOCKED / E_TOKEN_EXPIRED …),并标注哪些可重试。AI 能据此决策,文案爱怎么改怎么改,不破契约。
⑤ 导入不静默丢弃
认不出的命令行参数、解不出的字段、被丢弃的脚本,一律进导入警告,在预览界面里列给你看。静默丢弃是最坏的结果 —— 你会以为导进来了,直到调接口那天才发现少了东西。
三、功能一览
| 模块 | 能力 |
|---|---|
| 集合管理 | 无限层级文件夹,拖拽排序,全局搜索,命令面板 |
| 请求闭环 | 全方法支持,查询/头/表单/原始体/二进制/GraphQL,20+ 类网络错误分开报 |
| 环境变量 | {{var}} 占位符,secret 恒不回显,{{$uuid}} 等动态函数 |
| Token 源 | 绑到文件夹,自动刷新,并发单飞(航班锁),剩余有效期可视 |
| 历史与回收站 | 全局软删除,误删可还原 |
| 压测 | 并发可控,P50/P90/P95/精确分位 + TPS + 错误分布,导出独立 HTML 报表 |
| 导入 | curl、Postman v2.1、ApiPost、HAR 1.2、自有 JSON —— 导入前出差异树 |
| MCP / CLI | AI 双通道,共用同一份数据 |
| 外观 | 亮/暗主题 + 5 套强调色,主题与强调色是两个正交维度 |
| 窗口 | 自绘标题栏,去掉系统标题栏 |
支持的导入格式
| 格式 | 来源 |
|---|---|
| curl | 终端复制、文档、聊天记录 |
| Postman v2.1 | Postman 导出的 collection |
| ApiPost | ApiPost 原生导出 |
| HAR 1.2 | 浏览器 DevTools / Charles / Fiddler |
| Synapse JSON | 自己的备份格式 |
导入流水线:detect() 指纹识别 → parse() 解析 → 预览差异树(+新增 / ~更新 / =跳过)→ commit 落库。
四、快速开始
4.1 装桌面端
从 Releases 下载对应平台安装包,安装即用。
Windows 安装器会自动把安装目录加进用户 PATH —— 装完新开一个终端就能敲 reqly-cli。
4.2 接上 AI 客户端
打开 设置 → MCP,面板会给出与当前安装路径匹配的片段,直接粘进客户端配置。
// mcpServers
{
"reqly": {
"command": "C:/Users/<you>/AppData/Local/Synapse/reqly-mcp.exe",
"args": ["--db", "C:/Users/<you>/AppData/Roaming/com.reqly.desktop/reqly.db"],
"env": {}
}
}
只粘 reqly: 这一段,不要连 mcp_servers: 头一起。
reqly:
command: "C:/Users/<you>/AppData/Local/Synapse/reqly-mcp.exe"
args: ["--db", "C:/Users/<you>/AppData/Roaming/com.reqly.desktop/reqly.db"]
enabled: true
timeout: 120
connect_timeout: 60
trust: untrusted
路径一律输出正斜杠。 YAML 双引号里
\U不是合法转义,\t/\n却恰好合法 —— 后者会让路径被静默改写成带制表符的字符串,配置文件看着没问题、进程却找不到文件。
接上之后 AI 就有 13 个 tool:
| 分类 | tool |
|---|---|
| 浏览 | list_folders list_requests get_request list_environments |
| 编辑 | create_request update_request move_request delete_request |
| 执行 | send_request run_load_test |
| Token | refresh_token |
| 变量 | set_env_var |
| 导入 | import_curl |
delete_request 是软删除(进回收站,桌面端可还原)。secret 变量和 access token 永不过 MCP 通道 —— refresh_token 只回有效期。
4.3 CLI 速览
CLI 需要知道库在哪:--db 指定,或设一次环境变量 REQLY_DB(桌面端「设置」页能直接看到绝对路径)。
export REQLY_DB="$APPDATA/com.reqly.desktop/reqly.db" # Windows,或每次传 --db
reqly-cli folders # 列出集合
reqly-cli requests list --json | jq '.requests[] | .name'
reqly-cli send --request-id 151 # 发一条已保存的请求
reqly-cli send 151 --max-body-bytes 0 > resp.json # 大响应不截断,直接落文件
reqly-cli env list # 看当前环境变量(secret 恒为 ••••)
reqly-cli --help # 全部 7 组子命令
7 组子命令:folders requests env send loadtest token import
全局开关:
| 开关 | 作用 |
|---|---|
--db <PATH> |
库路径(也可用 REQLY_DB);文件不存在会新建空库 |
--json |
stdout 只出一份 JSON,形状与 MCP 返回一致 |
--read-only |
11 个写操作一律返回 E_READ_ONLY,不碰库 |
--max-body-bytes <N> |
响应体截断上限,0 = 不在这一层截 |
退出码:0 成功 · 1 业务失败(具体错误码在 stderr)· 2 命令行写错了。
脚本按 1 / 2 区分「业务失败」与「调用方式不对」—— 前者改数据,后者改命令。
输出约定:数据一律走 stdout,日志一律走 stderr。 所以
--json可以放心直接管道给jq。
4.4 MCP 还是 CLI?
| MCP Server | CLI | |
|---|---|---|
| 适合 | 边聊边查,AI 自己找接口 | 脚本、管道、批处理 |
| 传输 | JSON-RPC(stdio / 127.0.0.1 HTTP) | 进程 stdout |
| 响应体 | 硬截 64KB | --max-body-bytes 0 可不截,适合落文件 |
| 上下文成本 | 13 个 tool schema 常驻 | 零,--help 现查 |
| 只读模式 | --read-only |
--read-only |
不是二选一:查和聊走 MCP,批处理和管道走 CLI。
MCP 也支持 HTTP 通道(只绑回环,不对外):
reqly-mcp --db <path> --http --port 7777
五、从源码构建
需要:Node.js ^20.19.0 || >=22.12.0 · pnpm · Rust stable · MSVC 生成工具
(Windows 上由 Visual Studio 2022 / VS Build Tools 提供,勾选「使用 C++ 的桌面开发」)
git clone https://github.com/yanghuiwei/Synapse.git
cd Synapse
pnpm install
pnpm tauri dev # 开发
pnpm tauri build # 出安装包
分开构建两个 sidecar:
pnpm mcp:build # reqly-mcp.exe
pnpm cli:build # reqly-cli.exe
Windows 目标三元组是
x86_64-pc-windows-msvc,编译期需要 MSVC 链接器(link.exe)。 但这只是构建依赖 —— 产出物静态链接了 VC 运行时(static_vcruntime), 终端用户不需要装 VS,也不需要 VC++ 可再发行包。
六、技术栈
桌面端 React 19 · TypeScript · Tailwind v4 · zustand · uplot · Tauri 2
核心 Rust · SQLite(bundled)· reqwest(rustls + 系统根证书)· tokio · rusqlite + r2d2
AI 通道 rmcp(JSON-RPC / stdio / axum 回环 HTTP)· clap
架构分层
┌─────────────┐ ┌──────────────┐ ┌────────────┐
│ reqly │ │ reqly-mcp │ │ reqly-cli │
│ 桌面端 │ │ MCP Server │ │ 命令行 │
│ + tauri │ │ + rmcp/axum │ │ + clap │
└──────┬──────┘ └──────┬───────┘ └─────┬──────┘
│ │ │
└────────────────┴────────────────┘
│
┌─────────▼──────────┐
│ reqly-core │
│ 不含 tauri/rmcp/axum│
│ 错误码 · 存储 · HTTP│
│ 模板 · 压测 · 导入 │
└─────────┬──────────┘
│
┌─────▼─────┐
│ reqly.db │ 单文件
└───────────┘
三个入口唯一的差别是谁来触发、结果怎么呈现。共用的编排逻辑只有一份实现(service::ops,15 个操作),MCP 暴露其中 13 个给 AI,CLI 全给。
七、文档
| 文档 | 内容 |
|---|---|
| 设计文档 | 定位、决策记录、数据模型、模块设计 |
| 压测精度校准 | 内置引擎 vs ApacheBench 的分位数配对实测 |
| docs 说明 | 目录里还有什么、各自是什么 |
代码里的注释密度不低,几个核心 crate 的模块头文档(lib.rs / server.rs / ops.rs)值得一读,那里有不少「为什么这么写」的记录 —— 特别是几处本地验不出来、只有真实环境才暴露的问题是怎么处理的。
八、贡献
欢迎参与。动手前请读 贡献指南 —— 里面写了本地要过哪些门禁, 以及一条容易踩的坑:别在三个平台共用的 crate 里引入只在 Windows 上成立的依赖 (本机验不出来,只有 Linux CI 会红)。
git checkout -b feat/your-feature
# ...
git commit -s -m "feat(scope): 一句话说清做了什么"
提交信息跟随 Conventional Commits,发版由 release-please 自动化 —— 版本号和 CHANGELOG 不要手改。
参与即表示同意遵守 行为准则。 发现安全问题见 安全策略 —— 不要用公开 Issue 报告。
| 🐛 报告 Bug | 请附上「你是怎么发现的」 |
| 💡 功能请求 | 先说问题,别直接跳到方案 |
| ❓ 配置问题 | 安装 / 接 MCP / 构建 |
九、许可证
MIT © 2026 yhweix
可以自由使用、复制、修改、合并、发布、分发、再许可与销售 —— 包括商业用途。唯一的义务是在副本或实质性部分里保留版权声明与许可声明。
软件按「原样」提供,不附带任何明示或暗示的担保。
Synapse MCP questions
Does Synapse require an account or cloud synchronization?
No, Synapse is local-first, requires no account, and has no telemetry or cloud sync by default.