mcpField
C
cli-anything-chromadb

cli-anything-chromadb

github.com/hkuds数据与数据库57.6k514 次安装5 周前更新
代码仓库

关于 cli-anything-chromadb

cli-anything-chromadb 是面向 AI Agent 和高级用户的无状态命令行工具，通过 HTTP API v2 管理 ChromaDB。它提供集合与文档操作、语义查询及供程序解析的 JSON 输出。

主要功能

  1. 01管理集合的创建、查询与删除
  2. 02添加、获取、删除和统计文档
  3. 03执行集合语义搜索
  4. 04支持交互式 REPL
  5. 05提供机器可读 JSON 输出

适用场景

  1. 01通过命令行维护 ChromaDB 集合
  2. 02向集合写入或检索文档
  3. 03让 AI Agent 解析查询结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-chromadb

安装后在 Claude Code 中输入/cli-anything-chromadb确认已加载。

详细介绍

cli-anything-chromadb

一个面向 ChromaDB 向量数据库的无状态命令行界面，基于 HTTP API v2 构建。专为需要在没有浏览器 UI 的情况下管理集合、文档并运行语义查询的 AI Agent 和高级用户设计。

安装

此 CLI 作为 cli-anything-chromadb 包的一部分安装：

pip install cli-anything-chromadb

前置要求：

  • Python 3.10+
  • 在 localhost:8000 上运行的 ChromaDB 服务（或通过 --host 指定）

用法

基本命令
# Show help
cli-anything-chromadb --help

# Start interactive REPL mode
cli-anything-chromadb

# Check server health
cli-anything-chromadb --json server heartbeat

# List all collections
cli-anything-chromadb --json collection list

# Semantic search
cli-anything-chromadb --json query search --collection hub_knowledge --text "How to deploy"
REPL 模式

当不带子命令调用时，CLI 会进入交互式 REPL 会话：

cli-anything-chromadb
# Enter commands interactively with tab-completion and history

命令组

server

服务健康状态和版本命令。

命令描述
heartbeat检查 ChromaDB 服务健康状态
version获取 ChromaDB 服务版本
collection

管理 ChromaDB 集合。

命令描述
list列出所有集合
create --name NAME创建新集合
delete --name NAME删除集合
info NAME获取集合信息
document

管理集合中的文档。

命令描述
add --collection C --id ID --document TEXT添加文档
get --collection C获取文档
delete --collection C --id ID删除文档
count --collection C统计文档数量
query

对集合进行语义搜索。

命令描述
search --collection C --text T语义搜索

输出格式

所有命令都支持两种输出模式：

  • 人类可读（默认）：表格、颜色、格式化文本
  • 机器可读（--json 标志）：供 Agent 使用的结构化 JSON
# Human output
cli-anything-chromadb server heartbeat

# JSON output for agents
cli-anything-chromadb --json server heartbeat

面向 AI Agent

以编程方式使用此 CLI 时：

  1. 始终使用 --json 标志以获得可解析的输出
  2. 检查返回码 - 0 表示成功，非零表示错误
  3. 失败时解析 stderr 以获取错误消息
  4. 使用 --host 连接到非默认的 ChromaDB 实例

版本

1.0.0

评论

支持 Markdown