Fast MCP Local

Minimal local MCP server exposing document query tools for search, listing, and content retrieval.

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": {
    "karthik78180-fast-mcp-local": {
      "command": "python3",
      "args": [
        "-m",
        "fast_mcp_local.server"
      ]
    }
  }
}

You can run a lightweight local MCP server that exposes document query tools you can call from an MCP client. This server lets you search documents, list all documents with metadata, and retrieve full content for a specific document, enabling quick access to your documentation corpus in local development.

How to use

Use a compatible MCP client to connect to the local server and call its tools to search, list, and fetch documents. The server provides the following capabilities:

Document search: look up content across your documents with search_documents(query) to quickly find relevant material.

How to install

Prerequisites: you need Python 3.10 or higher.

# Create and activate a virtual environment (use an appropriate Python version)
python3 -m venv .venv
source .venv/bin/activate

# Install dependencies in editable mode including development extras
pip3 install -e ".[dev]"

Run the server

python3 -m fast_mcp_local.server

Run tests

pytest

Available tools

search_documents

Search documents by content and return matching results limited by a specified maximum.

get_all_documents

Return a list of all documents with their metadata such as filename, title, and size.

get_document

Fetch the full content of a specific document by filename.