公开记录
软件健康报告模式 0.34.0 · 指标 2.10.0 · 2026-08-22 20:04 UTC

Synapsor / Synapsor-Runner

Let AI agents query and update Postgres/MySQL without raw SQL, unrestricted schema access, or database credentials in the model; writes stay reviewed.

TypeScript · JavaScriptApache-2.0★ 2 星标⑂ 0 复刻始于 2026年7月在 GitHub 上查看 ↗
类型MCP 服务器命令行工具库如何判定
#agent-security#ai-agents#database-security#llm#mcp#model-context-protocol#mysql#open-source#postgresql#typescript#human-in-the-loop#llm-security#postgres#prompt-injection#rls#tenant-isolation#text-to-sql

Synapsor/Synapsor-Runner 的健康指数为 100 分中的 77 分，处于「良好」区间。 其得分最高的类别是AI Readiness（85/100），最低的是Community & Adoption（48/100）。 最近一次更新在 1 天前。 近期的大部分工作由 1 位贡献者完成。

77
总分 / 100
良好

软件健康指数

指标归入加权类别，统一采用 1–100 量表。总体分先取类别加权平均，再依据公开记录的分布进行校准，使各等级具有百分位含义；当公开证据触发高风险司法辖区政策时，评级会按政策调整，并设置 34（存在风险）的上限。

77
卓越93-100公开记录中的最高层级（约前 5%）；基本满足所有检验标准
优秀80-92各方面均表现强劲；仅有少量不足
良好65-79健康；不足之处有限且可控
中等50-64可接受，但存在明显不足；建议进行审查
薄弱35-49多个领域存在实质性薄弱环节
存在风险20-34存在重大薄弱环节；采用时应保持审慎
危急1-19问题严重（项目被弃置、仅有单一维护者、缺乏基本工程规范）
活力社区与采用可持续性与治理工程质量安全AI 就绪度

评分画像

每条轴代表一个类别。形状比平均值更重要——健康的对象会填满整个图形，而“一峰一谷”式画像意味着某一维度的优势正掩盖另一维度的风险。

加权总体分 66 经校准后在公布的指数量表上为 77（记录校准 2026-08-02）。

所有权

Synapsor组织
0 关注者1 个公开仓库始于 2026年7月

该仓库由组织支持——共同承担、可问责的托管责任，可延续于任何单一维护者之后。

软件包生态系统

注册表软件包版本月下载量版本数最近发布标签
npm@synapsor/runner1.7.112,960571 天前mcppostgresmysqlai-agentssql-safetydatabase-safetyopenai-agentsclaudecursorwritebackreplaymodel-context-protocoltext-to-sqlhuman-in-the-loopexecute-sqlprompt-injectiontenant-isolationdatabase-securityrls
npm@synapsor/dsl1.10.01,325202 天前synapsordslai-agentsmcpdatabase-safety
npm@synapsor/spec1.10.01,505162 天前synapsorai-agentsmcpdatabase-safetycontracts
npm@synapsor/cli0.1.0-beta.132136 天前—

按类别列示的指标

活力

项目是否仍有生命——是否仍在编写代码，是否仍在发布版本？

68良好 · 占总体的 21%

开发活跃度

65良好
评分方式
36/36推送新近度 — 最近一次推送于 1 天前
4.8/36提交节奏 — 52 周中有 7 周有提交
18/18提交量 — 最近一年 173 次提交
0/10OpenSSF Scorecard：Maintained — 无数据
所用输入
commits_last_year173
human_commit_share1
days_since_last_push1
active_weeks_last_year7

发布纪律

72良好
评分方式
16.2/27有发布版本 — 1 个版本标签（无 GitHub 发布版本）
36/36发布时效 — 最近一次发布版本于 41 天前
12.6/27发布节奏 — 节奏未知（仅一次发布）
0/10OpenSSF Scorecard：Signed-Releases — 无数据
所用输入
releases_count1
latest_release_tagv1.0.0
releases_from_tags是
days_since_latest_release41
mean_days_between_releases—

社区与采用

项目是否拥有用户、下载量与关注度，并具备欢迎贡献者参与的配置？

48薄弱 · 占总体的 17%

流行度与采用

1危急
评分方式
0/60星标 — 2 个星标
0/25复刻 — 0 个复刻
0/15关注者 — 0 位关注者
所用输入
forks0
stars2
watchers0
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

社区健康

92优秀
评分方式
22.5/22.5README
22.5/22.5许可证 — 可识别的许可证（Apache-2.0）
18/18CONTRIBUTING 指南
13.5/13.5行为准则
0/7.2议题模板
6.3/6.3PR 模板
所用输入
has_readme是
has_license是
readme_badges3
has_contributing是
has_issue_template否
has_code_of_conduct是
readme_badge_servicesgithub.com, shields.io
has_pull_request_template是

生态采用（下载量）

63中等
评分方式
50.2/80月度下载量 — npm 合计每月 5,822 次下载
0/20注册表被依赖数 — 该生态系统不报告此项
所用输入
packages@synapsor/runner, @synapsor/dsl, @synapsor/spec, @synapsor/cli
dependents—
ecosystemsnpm
total_downloads—
monthly_downloads5,822
unverified_packages_excluded—
已排除计分（无数据或不适用）：注册表被依赖数。 其余权重已重新归一化。

可持续性与治理

项目能否在其成员之外延续——巴士系数、响应能力、由谁支持，以及软件包的维护状况？

52中等 · 占总体的 23%

维护者韧性（巴士系数）

12危急
评分方式
9/54巴士系数 — 1 位贡献者贡献了半数提交
0/22.5提交分布 — 头号贡献者编写了 100% 的提交
1.4/13.5贡献者广度 — 1 位贡献者
0/10OpenSSF Scorecard：Contributors — 无数据
所用输入
bus_factor1
contributors_sampled1
top_contributor_share1

议题与 PR 响应能力

80优秀
评分方式
0/42议题解决 — 没有议题或无数据
24.1/30PR 接受 — 已裁定的 PR 中 49/61 已合并
0/13Newcomer PR acceptance — 30 天内没有首次贡献者的 PR 得到裁决
0/15OpenSSF Scorecard：Code-Review — 无数据
所用输入
merged_prs49
open_issues0
closed_issues0
prs_merged_7d5
prs_decided_7d5
prs_merged_30d20
prs_decided_30d20
issue_closed_ratio—
closed_unmerged_prs12
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
已排除计分（无数据或不适用）：议题解决, Newcomer PR acceptance。 其余权重已重新归一化。

所有权与托管责任

32存在风险
评分方式
30/30所有权背书 — 组织持有
0/20已验证域名
0/25所有者影响力 — Synapsor 有 0 位关注者
2.4/25既往记录 — 1 个公开仓库，账户约 0 年
所用输入
followers0
owner_typeOrganization
is_verified否
owner_loginSynapsor
public_repos1
account_age_days47

软件包维护

100卓越
评分方式
25/25已发布且可解析 — npm 上有 4 个软件包
35/35发布时效 — 最近一次发布于 1 天前
20/20版本历史 — 57 个已发布版本
20/20未被弃用 — 活跃，未被弃用或撤回
所用输入
packages@synapsor/runner, @synapsor/dsl, @synapsor/spec, @synapsor/cli
ecosystemsnpm
any_deprecated否
min_days_since_publish1

工程质量

基础的工程与文档实践是否到位？

76良好 · 占总体的 19%

工程实践

60中等
评分方式
24/24CI 工作流 — 5 个工作流
24/24存在测试
0/16Linter 配置
0/9.6Pre-commit 钩子
0/6.4.editorconfig
0/20OpenSSF Scorecard：CI-Tests — 无数据
所用输入
has_ci是
has_tests是
has_editorconfig否
has_linter_config否
has_precommit_config否

文档

100卓越
评分方式
30/30README
25/25文档目录
15/15文档 / 主页站点 — https://synapsor.ai/
10/10仓库描述
10/10主题标签 — 17 个主题标签
10/10Wiki
所用输入
topicsagent-security, ai-agents, database-security, llm, mcp, model-context-protocol, mysql, open-source, postgresql, typescript, human-in-the-loop, llm-security, postgres, prompt-injection, rls, tenant-isolation, text-to-sql
has_wiki是
homepagehttps://synapsor.ai/
docs_sitehttps://synapsor.ai/
has_readme是
has_docs_dir是
has_description是

安全

可见的安全与供应链实践是否稳固，且不存在未解决的高风险司法辖区暴露？

84优秀 · 占总体的 16%

安全态势

80优秀
评分方式
30/30安全策略（SECURITY.md）
25/25Dependabot 配置
25/25依赖锁定文件 — pnpm-lock.yaml
0/20CodeQL 工作流
所用输入
sourcefile_signals
lockfilespnpm-lock.yaml
manifestspackage.json
has_codeql_workflow否
has_security_policy是
has_dependabot_config是

依赖安全公告

100卓越
评分方式
35/35直接依赖不含已知公告 — 没有直接依赖携带已知公告
25/25间接依赖不含已知公告 — 没有间接依赖携带已知公告
0/40没有长期未处理的公告 — 没有公告带有发布日期
所用输入
sourceosv
advisories0
affected_packages0
assessed_packages131
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
已排除计分（无数据或不适用）：没有长期未处理的公告。 其余权重已重新归一化。 比对的是 npm:@synapsor/runner@1.7.11 的运行时依赖闭包——安装已发布的软件包时真正被拉取进来的内容——共 131 个软件包。 未对可达性进行分析。

AI 就绪度

该仓库在多大程度上具备与 AI 编码代理协同开发与维护的条件？权重刻意设小（4%）：代理工具链是一项真实的维护信号，但完全不具备的仓库仍可达到 100/100。

85优秀 · 占总体的 4%

AI 代理上下文与指引

81优秀
评分方式
45/45代理指令 — .cursor/rules/synapsor.mdc, .github/copilot-instructions.md, AGENTS.md, CLAUDE.md
15/15机器可读文档（llms.txt） — 存在 llms.txt
21.3/40可读的提交历史 — 100 次人类提交中有 40 次说明了意图（结构化标题或解释性正文）
所用输入
has_llms_txt是
llms_txt_url—
legible_history_share0.4
agent_instruction_files.cursor/rules/synapsor.mdc, .github/copilot-instructions.md, AGENTS.md, CLAUDE.md
agent_instruction_max_bytes4,025

验证循环（构建 / 测试 / 类型检查）

78良好
评分方式
18/18一条命令的引导启动 — examples/claude-desktop-postgres/Makefile, examples/cursor-postgres/Makefile, examples/mysql-refund-agent/Makefile, examples/openai-agents-http/Makefile, examples/openai-agents-stdio/Makefile, examples/raw-sql-vs-synapsor/Makefile, examples/support-billing-agent/Makefile
22/22自动化测试
0/11Lint / 格式化配置
11/11静态类型检查 — apps/cloud-cli/tsconfig.json, apps/runner/tsconfig.json, packages/config/tsconfig.json, packages/control-plane-client/tsconfig.json, packages/dsl/tsconfig.json, packages/handler/tsconfig.json, packages/mcp-server/tsconfig.json, packages/mysql/tsconfig.json, packages/postgres/tsconfig.json, packages/proposal-store/tsconfig.json, packages/protocol/tsconfig.json, packages/schema-inspector/tsconfig.json, packages/spec/tsconfig.json, packages/worker-core/tsconfig.json, tsconfig.json
10/10可复现环境 — Dockerfile, lockfile
4/10已体现的代理实践 — 最近 100 次提交中有 2 次由代理编写或署名代理
5/8自动化维护 — 已配置依赖自动化，但在抽样提交中未观察到
0/10OpenSSF Scorecard：Pinned-Dependencies — 无数据
所用输入
has_nix否
has_tests是
lockfilespnpm-lock.yaml
has_dockerfile是
typed_language是
bootstrap_filesexamples/claude-desktop-postgres/Makefile, examples/cursor-postgres/Makefile, examples/mysql-refund-agent/Makefile, examples/openai-agents-http/Makefile, examples/openai-agents-stdio/Makefile, examples/raw-sql-vs-synapsor/Makefile, examples/support-billing-agent/Makefile
has_devcontainer否
has_linter_config否
typecheck_configsapps/cloud-cli/tsconfig.json, apps/runner/tsconfig.json, packages/config/tsconfig.json, packages/control-plane-client/tsconfig.json, packages/dsl/tsconfig.json, packages/handler/tsconfig.json, packages/mcp-server/tsconfig.json, packages/mysql/tsconfig.json, packages/postgres/tsconfig.json, packages/proposal-store/tsconfig.json, packages/protocol/tsconfig.json, packages/schema-inspector/tsconfig.json, packages/spec/tsconfig.json, packages/worker-core/tsconfig.json, tsconfig.json
agent_commit_share0.02
toolchain_manifests—
dependency_bot_commit_share0

面向模型的代码可读性

94卓越
评分方式
45/45可类型检查的代码 — TypeScript（静态类型）
48.7/55可控的文件大小 — 采样的 421 个源文件中有 48 个超过 60KB
所用输入
primary_languageTypeScript
largest_source_bytes540,369
source_files_sampled421
oversized_source_files48

机器可读接口

100卓越
评分方式
40/40API 模式（OpenAPI/GraphQL/proto） — fixtures/generators/openapi/openapi.yaml
20/20MCP 服务器
40/40可运行示例 — examples, recipes
所用输入
example_dirsexamples, recipes
has_mcp_signal是
api_schema_filesfixtures/generators/openapi/openapi.yaml
interfaces_expected_of—

关键数据

2GitHub 星标
1贡献者
173最近 12 个月提交数
1距最近推送天数
1发布版本数
1巴士系数（bus factor）
0开放议题
npm软件包生态系统数

数据采集警告

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
  • Could not fetch npm package '@synapsor-runner/mysql' from its registry
  • Could not fetch npm package '@synapsor-runner/config' from its registry
  • Could not fetch npm package '@synapsor/handler' from its registry
  • Could not fetch npm package '@synapsor-runner/postgres' from its registry
  • GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
  • OpenSSF Scorecard did not return a usable result (Skipping github.com/Synapsor/Synapsor-Runner: run: RepoClient.LocalPath: error during tarballHandler.setup: internal error: handler.httpClient.Do: Get "https://codeload.github.com/Synapsor/Synapsor-Runner/legacy.tar.gz/refs/heads/main": internal error: innerTransport.RoundTrip: internal error: innerTransport.RoundTrip: error in HTTP: dial tcp: lookup codeload.github.com on 127.0.0.11:53: server misbehaving); skipping Scorecard checks

更多细节

直接依赖 45
注册表软件包版本约束清单文件
npm@modelcontextprotocol/sdk1.29.0apps/runner/package.json
npm@synapsor/specworkspace:^1.10.0apps/runner/package.json
npmjose6.2.3apps/runner/package.json
npmjsonc-parser3.3.1apps/runner/package.json
npmmysql2^3.11.0apps/runner/package.json
npmpdf-lib1.17.1apps/runner/package.json
npmpg^8.13.0apps/runner/package.json
npmtypescript5.9.3apps/runner/package.json
npmvscode-languageserver9.0.1apps/runner/package.json
npmvscode-languageserver-textdocument1.0.12apps/runner/package.json
npmyaml2.8.3apps/runner/package.json
npmzod^3.25.0apps/runner/package.json
npm@synapsor/specworkspace:*packages/config/package.json
npm@synapsor-runner/protocolworkspace:*packages/control-plane-client/package.json
npm@synapsor/specworkspace:^1.10.0packages/dsl/package.json
npmpg^8.13.0packages/handler/package.json
npmzod^3.25.0packages/handler/package.json
npm@modelcontextprotocol/ext-apps1.7.4packages/mcp-server/package.json
npm@modelcontextprotocol/sdk1.29.0packages/mcp-server/package.json
npm@synapsor-runner/configworkspace:*packages/mcp-server/package.json
npm@synapsor-runner/control-plane-clientworkspace:*packages/mcp-server/package.json
npm@synapsor-runner/postgresworkspace:*packages/mcp-server/package.json
npm@synapsor-runner/proposal-storeworkspace:*packages/mcp-server/package.json
npm@synapsor-runner/protocolworkspace:*packages/mcp-server/package.json
npm@synapsor-runner/schema-inspectorworkspace:*packages/mcp-server/package.json
npm@synapsor/specworkspace:*packages/mcp-server/package.json
npmjose6.2.3packages/mcp-server/package.json
npmmysql2^3.11.0packages/mcp-server/package.json
npmpg^8.13.0packages/mcp-server/package.json
npmzod^3.25.0packages/mcp-server/package.json
npmzod-to-json-schema3.25.2packages/mcp-server/package.json
npm@synapsor-runner/protocolworkspace:*packages/mysql/package.json
npm@synapsor-runner/worker-coreworkspace:*packages/mysql/package.json
npmmysql2^3.11.0packages/mysql/package.json
npm@synapsor-runner/protocolworkspace:*packages/postgres/package.json
npm@synapsor-runner/worker-coreworkspace:*packages/postgres/package.json
npmpg^8.13.0packages/postgres/package.json
npm@synapsor-runner/protocolworkspace:*packages/proposal-store/package.json
npmzod^3.25.0packages/protocol/package.json
npm@synapsor/runnerworkspace:1.7.11packages/runner-alias/package.json
npm@synapsor-runner/protocolworkspace:*packages/schema-inspector/package.json
npmmysql2^3.11.0packages/schema-inspector/package.json
npmpg^8.13.0packages/schema-inspector/package.json
npm@synapsor-runner/control-plane-clientworkspace:*packages/worker-core/package.json
npm@synapsor-runner/protocolworkspace:*packages/worker-core/package.json
全部依赖 未采集

本报告未能采集到解析后的依赖集合：GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository

依赖安全公告 0

安装 npm:@synapsor/runner@1.7.11 会引入 131 个包（直接与传递）：其中 0 个存在已知公告，0 个为直接依赖。

没有已知公告影响已评估的依赖。

公告表示依赖图中记录的版本落入某条公告的受影响范围。可达性未经分析，且依赖图包含开发与测试的版本固定——某项发现可能只涉及工具链而非交付的软件。

原始 JSON 报告 机器可读

反馈

发现这份报告有不准确之处，或有想法要分享？错误的测量、未识别的工具、建议、疑问——都欢迎提出。每条消息都会被阅读并得到回复。

登录过程中消息不会丢失。

相关记录

与 Synapsor/Synapsor-Runner 共享目录标签或生态系统的已检测仓库。 并排阅读 →

98googleapis/mcp-toolboxMCP Toolbox for Databases is an open source MCP server for databases.卓越98Agenta-AI/agentaAgenta is a workspace where you and your team build agents and automations.卓越98ComposioHQ/composioComposio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.卓越97strands-agents/harness-sdkBuild an agent harness and control it end-to-end. Open-source SDK for production AI agents in Python & TypeScript - any model, any cloud.卓越98langchain-ai/langchainThe agent engineering platform.卓越100deepset-ai/haystackOpen-source AI orchestration framework for building context-engineered, production-ready LLM applications. Design modular pipelines and agent workflows with explicit control over retrieval, routing, memory, and generation. Built for scalable agents, RAG, multimodal applications, semantic search, and conversational systems.卓越

评分是信号，而非担保。 评分反映的是 GitHub 上公开可见的实践——不是代码审计，也不是安全保证。

缺失数据将被剔除并重新归一化权重，绝不按零分计。方法论已版本化并公开：指标 v2.10.0、模式 v0.34.0—— 完整方法论 · 指标知识库.

单项结果在整体记录中的位置： 汇总统计 — npm.