Practical overview
When it fits
Use it when you need a graphical administration interface for a PostgreSQL/pgvector document collection and want MCP-enabled assistants to access its search or management tools.
Who it is for
- Teams maintaining document collections in PostgreSQL with pgvector.
- Developers connecting document search and collection-management workflows to MCP-capable assistants.
Documented uses
- Create and manage collections with custom metadata.
- Upload, organize and remove documents in supported formats.
- Search documents semantically, by keyword or with hybrid retrieval.
- Make collection, document and search operations available as MCP tools.
Requirements & limits
The README documents a self-hosted setup using Docker Compose, a Supabase account and configured Supabase credentials.
- The documented database foundation is PostgreSQL with pgvector.
- Supported document formats listed are PDF, TXT, MD, DOCX and HTML.
- Semantic search uses OpenAI embeddings; keyword search uses PostgreSQL full-text search.
- MCP configuration is documented for Claude Desktop and Cursor, with stdio and SSE transports.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up and start LangConnect Client with Docker Compose
Build the application and start its services for local access.
Before you start
- Docker and Docker Compose
- A Supabase account
Steps
Clone the repository and enter its directory: the command below followed by
cd langconnect-client.git clone https://github.com/teddynote-lab/langconnect-client.gitCopy
.env.exampleto.env, create a Supabase project, and setSUPABASE_URLandSUPABASE_KEYin.envusing the project URL and anon public key.Build the Docker images with the command below.
make buildStart the services with the command below, then use the frontend at
http://localhost:3000. Run the command below to stop them.make upmake down
Expected outcome
The services are started, with the frontend listed at `http://localhost:3000`.
Guide limitations
- The documented prerequisites also list Node.js 20+ for the MCP inspector and Python 3.11+ with UV; the quick start does not describe using the inspector.
- The README describes PostgreSQL with pgvector, but does not provide configuration steps for a database backend.
- The frontend URL is provided, but no specific GUI workflow for managing collections or documents is detailed.
Generate MCP configuration for Claude Desktop or Cursor
Generate the LangConnect MCP configuration and add it to an AI assistant's MCP settings.
Before you start
- Docker and Docker Compose
- A Supabase account and credentials
Steps
From the repository directory, run the command below.
make mcpRespond to the prompts for Supabase credentials; the command is described as obtaining an access token, updating
.env, and generatingmcpserver/mcp_config.json.For Claude Desktop, copy the contents of
mcpserver/mcp_config.jsoninto its MCP settings; for Cursor, add the configuration under MCP integrations.
Expected outcome
An MCP configuration file is generated and the README provides instructions to add it to Claude Desktop or Cursor.
Guide limitations
- This recipe does not describe starting the application services; use the documented Docker Compose setup first if you need the running application.
- No assistant-side verification or test procedure is provided.
Compare options for Vector search
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| Langconnect Client | Create and manage collections with custom metadata. | Self-hosted, Web | The README documents a self-hosted setup using Docker Compose, a Supabase account and configured Supabase credentials. |
| Chatbot with PDF for Semantic Search | Prepare document content as embeddings and save it to a supported vector database. | Web | The repository is identified as open source and publicly visible on GitHub. |
| AI LLM Playground | Ask questions about PDF documents through an assistant interface. | Web |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 17 October 2026
- Original website title
- braincrew-lab/langconnect-client · Official homepage title · retained in its source language

