{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_swtuqk887t5s","handle":"cocoindex-mcp","url":"https://wellknown.network/agents/cocoindex-mcp","links":{"self":"https://wellknown.network/agents/cocoindex-mcp/record.json","html":"https://wellknown.network/agents/cocoindex-mcp","markdown":"https://wellknown.network/agents/cocoindex-mcp/record.md","api":"https://wellknown.network/api/v1/agents/cocoindex-mcp","status":"https://wellknown.network/api/v1/agents/cocoindex-mcp/status","claim":"https://wellknown.network/agents/cocoindex-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/cocoindex-mcp/claim.json","badge":"https://wellknown.network/agents/cocoindex-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/cocoindex-mcp/history","tools":"https://wellknown.network/api/v1/agents/cocoindex-mcp/tools"},"ard":{"identifier":"urn:air::server:cocoindex-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"cocoindex-mcp","summary":"MCP server for querying cocoindex code embeddings database","description":"# cocoindex-mcp\n\nSemantic code search for Model Context Protocol clients, powered by cocoindex flows and a Postgres + pgvector backend.\n\n---\n\n## At a glance\n\n- 🔍 **Semantic search** over the embeddings produced by the cocoindex `CodeEmbedding` flow.\n- 🤝 **MCP-native** stdio server that drops straight into Claude Desktop, Cursor, and other MCP hosts.\n- ⚙️ **Zero-surprise configuration** via a single `COCOINDEX_DATABASE_URL` environment variable (with `.env` support).\n- 🚀 **Packaged for uv** – run it instantly with `uvx --from yalattas/cocoindex-mcp cocoindex-mcp`.\n\n## Table of contents\n\n- [At a glance](#at-a-glance)\n- [How it works](#how-it-works)\n- [Prerequisites](#prerequisites)\n- [Quick start](#quick-start)\n- [Configuration](#configuration)\n- [Running the server](#running-the-server)\n- [Available MCP tools](#available-mcp-tools)\n- [Troubleshooting](#troubleshooting)\n- [Local development](#local-development)\n- [Contributing](#contributing)\n- [License](#license)\n\n## How it works\n\nThe server wraps a cocoindex flow that embeds local source files into a Postgres table called `code_embeddings`. Every query is transformed with the same SentenceTransformer model and matched against the stored vectors using cosine similarity via `pgvector`. Results are streamed back to the MCP client with file paths, the matched snippet, score, and optional line numbers.\n\nInternally the server is built with:\n\n- [`mcp.server.fastmcp`](https://pypi.org/project/mcp/) to expose stdio-based MCP tools.\n- [`cocoindex`](https://pypi.org/project/cocoindex/) for defining and running the embedding flow.\n- [`psycopg_pool`](https://www.psycopg.org/psycopg3/docs/pool.html) and `pgvector` for high-throughput vector queries.\n- [`python-dotenv`](https://pypi.org/project/python-dotenv/) to honor environment files automatically.\n\n## Prerequisites\n\n1. **Python** ≥ 3.11 (only needed for local installs; `uvx` ships its own runtime).\n2. **PostgreSQL** with the [`pgvector`](https://github.com/pgvector/pgvecto…","publisher":{"name":"Yasser Alattas","url":null},"homepage":"https://github.com/yalattas/cocoindex-mcp","repository":"https://github.com/yalattas/cocoindex-mcp","version":"0.0.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:cocoindex-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"derived"}],"categories":["data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"cocoindex-mcp","registry":"pypi","observedAt":"2026-11-09T02:25:39.763Z","publishedAt":"2025-11-03T19:50:08.689179Z","latestVersion":"0.0.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"cocoindex-mcp","url":"https://pypi.org/project/cocoindex-mcp/","firstSeenAt":"2026-09-09T11:31:26.339Z","fetchedAt":"2026-11-09T02:24:11.712Z","normalizedAt":"2026-11-09T02:24:11.712Z"}]},"firstSeenAt":"2026-09-09T11:31:26.339Z","updatedAt":"2026-11-09T02:25:39.763Z"}