mcpField
V
vaultit

vaultit

本地服务
pypi.org记忆与知识032 周前更新
代码仓库访问官网

关于 vaultit

vaultit 面向使用多个 AI Agent 的开发者，提供项目上下文与会话连续性管理。它跟踪项目状态、任务、决策和会话，并生成可在不同 Agent 间传递的简报。

主要功能

  1. 01项目状态跟踪与同步
  2. 02Agent 会话和任务管理
  3. 03生成 AI Agent 上下文简报
  4. 04导出为 JSON 和 Markdown
  5. 05文件、SQLite 与 PostgreSQL 后端
  6. 06REST API 和 Python SDK

适用场景

  1. 01在不同 AI Agent 间延续项目上下文
  2. 02查看上次同步后的项目变更
  3. 03协调多个 Agent 并发访问
  4. 04导出项目上下文以供分享

MCP 相关

vaultit 提供包含 10 个工具的 MCP 服务，可原生集成 Claude Code。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "therealdataboss-vaultit": {
      "command": "uvx",
      "args": [
        "vaultit"
      ]
    }
  }
}
启动命令uvx vaultit

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypivaultit0.6.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

vaultit

mcp-name: io.github.TheRealDataBoss/vaultit

PyPI Python 3.10+ License: MIT MCP Native

让不同 AI Agent 之间的模型状态保持一致。

安装

pip install vaultit

快速开始

vaultit init
vaultit sync --agent claude
vaultit bootstrap --clipboard
# paste into any AI — full context restored

CLI 参考

命令描述
init搭建项目上下文框架 — 状态向量、约定和任务
sync扫描代码仓库，并使用当前项目状态更新状态向量
bootstrap生成可直接粘贴给任意 AI Agent 的简报
status显示已跟踪的项目及其当前状态
doctor验证上下文文件的一致性和缺失字段
migrate执行数据库架构迁移
export将项目上下文导出为 JSON/Markdown
diff显示自上次同步以来的变更
serve启动 REST API 服务（FastAPI + Uvicorn）
sessions列出并管理 Agent 会话
tasks列出并管理项目任务
decisions列出并管理架构决策
auth创建和撤销 API 密钥（ck_ 前缀，以 SHA-256 存储）

Python SDK

from vaultit import VaultItClient

client = VaultItClient()

# Sessions
session = client.create_session(agent="claude", project="myproject")
client.end_session(session.id, summary="Implemented auth module")

# Tasks & decisions
client.create_task(project="myproject", title="Add rate limiting")
client.create_decision(project="myproject", title="Use PostgreSQL", rationale="Need JSONB")

# Handoff
handoff = client.create_handoff(from_session=s1.id, to_agent="gpt-4")

MCP 服务

10 个工具 — 通过 Model Context Protocol 原生集成 Claude Code。

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "vaultit": {
      "command": "python",
      "args": ["-m", "vaultit.mcp"]
    }
  }
}

后端

# File (default) — zero config
vaultit init

# SQLite
vaultit init --backend sqlite

# PostgreSQL
vaultit init --backend postgres --db-url postgresql://user:pass@localhost/ck

REST API

14 个端点 + 3 个身份验证端点。使用 FastAPI，提供 OpenAPI 规范。

vaultit serve --port 8420
# → http://localhost:8420/docs   (Swagger UI)
# → http://localhost:8420/openapi.json

身份验证标头：Authorization: Bearer ck_your_api_key

多 Agent 协调

支持三种并发 Agent 访问模式：

  • sequential — 一次一个 Agent（默认）
  • lock-based — 按资源进行悲观锁定
  • merge — 通过冲突解决进行乐观合并

链接

许可证

MIT © TheRealDataBoss

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。