Embedbase

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 7, 2026

Vector collections and document search backed by a Chroma HTTP service.

已驗證STDIO僅桌面資料庫知識與記憶

概覽

AI 產生的概覽

面向 Chroma 相容向量服務的輕量 stdio MCP 用戶端，讓助理建立集合、寫入文件並進行最近鄰檢索。

可以做什麼
  • 列出、建立、檢視、重新命名與刪除向量集合，支援分頁與計數
  • 預覽集合中的文件，讀取集合中繼資料與設定
  • 加入帶中繼資料與 id 的文件，並更新既有紀錄
  • 依查詢文字做最近鄰檢索，並依 id 或篩選條件取得、刪除文件
適用情境
當你已經執行 Chroma 相容的向量服務，並希望助理直接管理其中的集合與文件時適用，例如建立或檢視小型向量庫、批次寫入文件、執行相似度查詢而不必手寫 API 呼叫。
執行需求
透過 npx 或 Docker 映像在本機執行；需要一個可存取的 Chroma 相容 HTTP 服務，以 CHROMA_URL 或 EMBEDBASE_URL 指定（預設 API 金鑰。
安裝前請注意
工具可建立、重新命名、更新與刪除集合及文件，包括依篩選條件批次刪除，變更會直接作用於線上向量庫。請只連線到你確實要修改的服務，並留意文件文字與中繼資料會傳送到該服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Embedbase，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

embedbase

embedbase gives an agent — or you, at a terminal — a tidy way to work with vector collections: create them, fill them with documents, and query them for the closest matches. It speaks to a Chroma-compatible HTTP service over its v2 REST API, so the embedding store stays a separate process and this tool stays a thin, testable client.

Point it at a running service with CHROMA_URL or EMBEDBASE_URL (without either, it assumes http://localhost:8000). Collections are addressed by name at the MCP and CLI layers; internally the client resolves each name to its server id before calling the id-scoped document endpoints, exactly as the REST API requires.

Install

bash
npx @reneturcios/embedbase list

Or run the container image:

bash
docker run -i ghcr.io/cloudcorprecords/embedbase

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash
# List collections (pagination is optional)embedbase list --limit 20 --offset 0
# Inspect one collection, or count its recordsembedbase info notesembedbase count notes
# Create a collectionembedbase create notes
# Start the MCP serverembedbase mcp
embedbase --version

Exit codes: 0 on success, 1 when the service call fails (the error includes the HTTP status), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/embedbase mcp

MCP client configuration:

json
{  "mcpServers": {    "embedbase": {      "command": "npx",      "args": ["-y", "@reneturcios/embedbase", "mcp"],      "env": { "CHROMA_URL": "http://localhost:8000" }    }  }}

Tools

All tools take collection_name (string) unless noted. Optional parameters are omitted from the request when not supplied.

ToolRequiredOptionalPurpose
chroma_list_collections—limit, offset (integers)List collections with pagination.
chroma_create_collectioncollection_namemetadata (object), embedding_function_name (string)Create a collection.
chroma_peek_collectioncollection_namelimit (integer)Preview documents in a collection.
chroma_get_collection_infocollection_name—Collection metadata and configuration.
chroma_get_collection_countcollection_name—Number of records in a collection.
chroma_modify_collectioncollection_namenew_name, new_metadataRename or re-tag a collection.
chroma_delete_collectioncollection_name—Delete a collection and its records.
chroma_add_documentscollection_name, documents (string array)metadatas, idsAdd documents; ids are generated deterministically when omitted.
chroma_query_documentscollection_name, query_texts (string array)n_results, where, where_document, includeNearest-neighbour query.
chroma_get_documentscollection_nameids, where, limit, offset, includeFetch documents by id or filter.
chroma_update_documentscollection_name, idsdocuments, metadatas, embeddingsUpdate existing records.
chroma_delete_documentscollection_nameids, whereDelete records by id or filter.

Requests go to the v2 tenant/database paths (/api/v2/tenants/default_tenant/databases/default_database/collections...). Service errors come back as tool errors carrying the HTTP status — results are never invented.

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, fake fetch only, no live servicenpm run dev     # run the CLI from source via tsx

The client core sits behind an injectable fetch function, which is what the test suite drives: URL construction, request bodies, id resolution, count unwrapping, and error surfacing are all covered without a running server.

License

MIT — see LICENSE.

來源：README.md，提交 e555a07

工具

12

chroma_list_collections

List collections in the database with optional pagination.

輸入參數limitoffset

chroma_create_collection

Create a new collection with optional metadata and embedding function.

輸入參數metadatacollection_name必填embedding_function_name

chroma_peek_collection

Return a preview of documents stored in a collection.

輸入參數limitcollection_name必填

chroma_get_collection_info

Get metadata and configuration details for a collection.

輸入參數collection_name必填

chroma_get_collection_count

Get the number of records stored in a collection.

輸入參數collection_name必填

chroma_modify_collection

Rename a collection or replace its metadata.

輸入參數new_namenew_metadatacollection_name必填

chroma_delete_collection

Delete a collection and all of its records.

輸入參數collection_name必填

chroma_add_documents

Add documents with optional metadata and ids to a collection.

輸入參數idsdocuments必填metadatascollection_name必填

chroma_query_documents

Query a collection for documents nearest to the given query texts.

輸入參數whereincluden_resultsquery_texts必填where_documentcollection_name必填

chroma_get_documents

Retrieve documents from a collection by ids or filter.

輸入參數idslimitwhereoffsetincludecollection_name必填

chroma_update_documents

Update documents, metadata, or embeddings for existing ids in a collection.

輸入參數ids必填documentsmetadatasembeddingscollection_name必填

chroma_delete_documents

Delete documents from a collection by ids or filter.

輸入參數idswherecollection_name必填

版本歷史

1
  1. v0.1.0最新Oct 31, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分