MCP Sqlew

sqlew

sqlew_logo

](https://www.npmjs.com/package/sqlew) 

SQL记住的设计决策 --用于AI代理的MCP服务器

什么是sqlew？

问题

每个AI编码会话都是从头开始的。您的代理不记得上周您选择了PostgreSQL而不是MongoDB，也不记得团队就特定的API版本控制策略达成了一致。如果没有持久内存，代理会重复错误，与之前的决策相矛盾，并浪费令牌重新发现上下文。

解决方案

sqlew将您的架构决策存储在结构化SQL数据库中。当一个新会话开始时，AI代理会在几毫秒内查询过去的决策——不是通过读取分散的Markdown文件，而是通过使用元数据、标签和相似性检测的高效SQL查找。

┌─────────────────────────────────────────────────────────────┐
│  Before sqlew                 │  After sqlew                │
│───────────────────────────────│─────────────────────────────│
│  Session 1: "Use PostgreSQL"  │  Session 1: "Use PostgreSQL"│
│  Session 2: "Use MongoDB?"    │    → decision recorded      │
│  Session 3: "Use PostgreSQL"  │  Session 2: query → got it  │
│  (same debate, every time)    │  Session 3: query → got it  │
│                               │    (instant recall)         │
└─────────────────────────────────────────────────────────────┘

sqlew构建在 模型上下文协议 （MCP），因此它适用于任何兼容MCP的AI编码工具。

_该软件不会向外部网络发送任何数据。我们从不收集任何数据或使用统计数据。_

快速开始

1.安装

npm install -g sqlew

2.设置

选择与您的环境相匹配的设置：

克劳德代码（插件）

claude plugin marketplace add sqlew-io/sqlew-plugin
claude plugin install sqlew

该插件自动配置MCP服务器、技能（计划模式指导）和钩子（自动决策捕获）。

Codex 命令行界面

看 sqlew代码 用于Codex CLI集成。

手册

添加 .mcp.json 在项目根目录中：

{
    "mcpServers": {
        "sqlew": {
            "command": "sqlew"
        }
    }
}

数据库(~/.config/sqlew/sqlew-shared.db)首次运行时会自动创建配置。看 共享数据库 了解详情。

3.只需使用计划模式！

就是这样。每次您创建计划并获得用户批准时，您的架构决策都是 自动录制.

无需特殊命令——只需正常规划您的工作，sqlew就会在后台捕获决策。

特性

• 结构化记录 --决策存储为具有元数据、标签、层和版本历史的关系数据
• 快速查询 --通过SQL检索2-50ms，即使有数千个决策
• 重复检测 --三层相似性评分（0-100）可防止冗余决策
• 约束跟踪 --作为一流实体的架构规则和原则
• 自动捕获 --钩子自动记录计划模式（Claude Code插件）中的决策
• 多数据库 --SQLite（默认）、PostgreSQL、MySQL/MariaDB或Cloud
• Git工作树就绪 --每个工作树共享相同的上下文数据库

适用于团队（sqlew.io）

连接到 sqlew.io 对于团队共同决策：

步骤1：获取API密钥

访问 sqlew.io 并保存您的API密钥：

# ~/.config/sqlew/.sqlew.env (shared across all projects)
SQLEW_API_KEY=your-api-key

步骤2：配置每个项目

# .sqlew/config.toml
[database]
type = "cloud"

[project]
name = "your-project-name"

优点：

• 所有团队成员共享同一个决策数据库
• 与Git工作树工作流无缝协作
• 无需设置本地数据库

演出

用例

• 架构演进 --在充分考虑背景和替代方案的情况下记录重大决策
• 图案标准化 --建立编码模式作为约束，通过AI代码生成强制执行
• 跨会话连续性 --AI在几天/几周内保持上下文，而无需重新阅读文档
• 多智能体协调 --多个AI代理共享架构理解
• 车载加速 --新的AI会话可立即了解项目历史

文档

升级指南

• 迁移到SaaS --将本地数据导出到sqlew.io云

MCP工具

7个基于行动的工具： decision, constraint, suggest, help, example, use_case, queue

所有工具支持 action: "help" 文件。

支持

通过以下方式支持发展 .

版本

当前版本： 5.0.8

看 更改日志.md 发布历史。

v5.0.8的新增功能：

• PR ADR执行 --PreTool使用钩块 gh pr create 无ADR标记，文件分组格式
• Codex CLI支持 --超越克劳德代码的作品 sqlew代码
• 插件优先架构 --通过sqlew插件简化设置
• 云后端 --连接到 sqlew.io 团队共同决策

许可证

Apache许可证2.0-免费供商业和个人使用。看 许可证 了解详情。

链接

• 问题
• 模型上下文协议

______________________________________________________________________