Documentation Search

Embeddings Searcher for MCP

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "thypon-kb": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "mcp_server.py"
      ]
    }
  }
}

You can run an MCP server that lets Claude Code search through embedded markdown documentation using semantic search. This setup indexes your docs, serves results to the Claude Code client, and can run locally for fast, offline testing or integrated workflows.

How to use

You will interact with the MCP server through your Claude Code client. Start by launching the server locally, then add it to Claude Code so it can communicate with your indexed documentation. Once connected, you can ask Claude Code questions like “Search for authentication patterns” or “Find API documentation” and receive relevant results with context and links to the original docs.

How to install

Prerequisites: make sure Python is installed on your system and you have a way to run UV-based commands in your shell.

Clone or obtain the project that contains the MCP server and the search components.
Install dependencies for the MCP server and the search tooling using your preferred Python/UV workflow.
Start indexing to scan your documentation repositories and build the embeddings database.
Run the MCP server to enable Claude Code integration and begin querying your indexed docs.
In Claude Code, add the MCP server so Claude can route queries to your locally indexed docs.

MCP server configuration and usage

The MCP server is designed to run as a local process that Claude Code can connect to. The standard runtime example is to launch the MCP server with UV using Python.

To start the MCP server locally, use the following command sequence.

uv run python mcp_server.py

MCP server connection details

The server is configured as a stdio-based MCP endpoint so Claude Code can start it as a local process and communicate over standard input/output.

{
  "mcpServers": {
    "docs_searcher": {
      "command": "uv",
      "args": ["run","python","mcp_server.py"]
    }
  }
}

Available tools

search_docs

Search documentation using semantic similarity across indexed markdown chunks and return ranked results with context.

list_repos

List all indexed documentation repositories available for searching.

get_stats

Retrieve indexing statistics including number of documents, chunks, and embeddings size.

get_document

Fetch full content of a document by repository path or identifier.