Skip to content

v2.2.0 — First GitHub release of 2.x line

Choose a tag to compare

@kiki830621 kiki830621 released this 14 Apr 11:51
· 5 commits to main since this release

Summary

First GitHub release of the 2.x line. Includes all the 2.0.0 refactor work that previously only existed as local builds, plus the error-message fix from #1.

Install

curl -fsSL https://github.com/PsychQuant/che-duckdb-mcp/releases/latest/download/CheDuckDBMCP -o $HOME/bin/CheDuckDBMCP
chmod +x $HOME/bin/CheDuckDBMCP

Or install via Claude Code plugin (auto-downloads):

/plugin install che-duckdb-mcp@psychquant-claude-plugins

Added (2.0.0 carryover)

  • TF-IDF inverted index search engine with cosine similarity scoring
  • Fuzzy matching for function names (Levenshtein distance ≤ 2, case/underscore-insensitive)
  • Multi-source documentation: llms.txt (3KB LLM reference) + duckdb-docs.md (5MB full docs)
  • Conditional HTTP caching with ETag/Last-Modified
  • Storage format version detection for .duckdb files
  • Graceful storageVersionMismatch error with upgrade suggestions
  • swiftBindingRevision field in db_info response

Fixed (#1)

  • db_query / db_execute / db_connect / db_list_tables / db_describe now surface DuckDB's actual error messages (Binder Error, Catalog Error, Parser Error, etc.) instead of opaque DuckDB.DatabaseError error N strings.

Changed

  • duckdb-swift pinned to commit d90cf8d (DuckDB v1.5.0-dev)
  • MCP Swift SDK upgraded to 0.12.0 (Swift 6 concurrency)
  • mcpb/manifest.json version synced to 2.2.0

Requirements

  • macOS 13+ (arm64)