Willow-MCP：Agent 中立的 MCP 服务器

Willow-MCP 是一款采用 Apache 2.0 许可证的 Agent 中立型 MCP 服务器，基于 Model Context Protocol 2.0 构建，为 AI 编码助手提供持久化记忆存储与任务执行能力。支持任何 MCP 客户端：Claude Code、Claude Desktop、Cursor、opencode 或任何兼容 stdio MCP 的自定义 Agent。

核心能力

• SOIL Store：基于 SQLite 的本地键值存储，支持全文搜索与软删除，开箱即用无需额外依赖
• Postgres 知识库：多关键词可搜索的知识图谱，结构化存储 Agent 协作产生的上下文信息
• Kart 任务队列：沙盒化任务执行器，支持运行 shell 命令与脚本，实现可信的自动化操作
• 文件系统 Manifest ACL：每次工具调用都经由基于清单的访问控制，无需外部 ACL 数据库或认证服务
• 零外部依赖：SOIL Store 独立运行，PostgreSQL 为可选项；Python 3.11 + 标准库即可启动
• 多客户端兼容：与 Claude Code、Claude Desktop、Cursor、opencode 等主流 Agent 工具无缝对接

安装配置

标准安装（pip）

pip install willow-mcp

初始化工作目录

willow-mcp-init    # 脚手架 $WILLOW_HOME（幂等）
willow-mcp-compile --force   # 编译 Manifest

配置 MCP 客户端

以 Claude Code 为例：

claude mcp add willow -- willow-mcp

或通过 uvx 一键运行（无需 pipx）：

uvx willow-mcp

本地沙箱快速启动（推荐试用）

一行命令完成完整沙箱搭建——虚拟环境、可编辑安装、$WILLOW_HOME 脚手架、Manifest 编译，以及本地 PostgreSQL（若无则自动创建所有必要表）：

bash scripts/sandbox-bootstrap.sh

脚本完全幂等；生成的 .willow/ 目录纳入 .gitignore，不影响真实集群状态。PostgreSQL 为可选项，传入 WILLOW_SKIP_PG=1 可仅运行 SOIL Store。

使用步骤

1. 安装：通过 pip 安装 willow-mcp，或使用 uvx 直接运行
2. 初始化：执行 willow-mcp-init 创建数据目录结构
3. 配置 Manifest：编写工具清单文件，定义 Agent 可调用的工具范围与权限
4. 启动服务：willow-mcp 以 stdio 模式运行，等待 Agent 连接
5. 编写 Manifest 角色（可选）：通过 willow-mcp-compile-persona 将种子数据编译为角色文件，支持多 Agent 分工场景

适用场景

• 个人 AI 编程助手：为本地 Claude Code / Cursor 提供持久化记忆，跨会话记住项目上下文与决策历史
• 团队协作 Agent：通过 Postgres 知识库共享团队知识图谱，多个 Agent 协作时保持信息一致性
• 自动化工作流：利用 Kart 任务队列执行脚本化任务，适合 CI/CD 场景中的 Agent 驱动流水线
• 私有化部署：零云依赖，所有数据存储在本地或私有 PostgreSQL，满足数据主权要求
• 多工具统一记忆层：将不同 Agent（Claude Code 写代码、opencode 做审查、Cursor 做设计）的经验汇聚到统一记忆存储

适用人群

• 使用 Claude Code、Cursor、opencode 等 AI 编程工具的专业开发者
• 需要为团队 Agent 搭建统一知识库的 DevOps / 平台工程师
• 对 AI 工具数据主权有要求的企业技术团队
• MCP 协议爱好者与插件开发者

工作原理

Willow-MCP 运行在 stdio 传输层之上，Agent 通过标准输入/输出与服务器通信。当 Agent 调用工具时，请求首先经过 Manifest ACL 校验——清单文件定义了哪些工具可以被哪些角色调用，防止权限冒用。通过 SOIL Store（SQLite）提供低延迟本地持久化；开启 Postgres 知识库后可获得向量式多关键词搜索能力；Kart 任务队列将 shell 命令封装为可追踪、可重试的异步任务。三种存储后端共用同一套 MCP 接口，Agent 无需感知底层差异。

官方链接

• PyPI：https://pypi.org/project/willow-mcp/
• GitHub：https://github.com/rudi193-cmd/willow-compose