Where is the data stored?

Data (ChromaDB database and model cache) is stored in the directory specified by the `DATA_ROOT` environment variable, defaulting to a `data` folder inside the package.

How does the initialization process work?

The server initializes ChromaDB and the embedding model asynchronously in the background, allowing it to accept requests immediately. Use the `get_initialization_status` tool to check when initialization is complete.

What credentials does it need?

It reads `DATA_ROOT`, `CHROMA_DB_FOLDER_NAME`, `SENTENCE_TRANSFORMER_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

WindTools MCP Server

Your own codebase tools like code semantic search

Local serverstdioPython

What is the WindTools MCP Server?

Your own codebase tools like code semantic search

What it actually does

MCP Server for the WindTools code assistant, providing document embedding and retrieval capabilities using ChromaDB and sentence transformers.

Semantic Code Search — Uses sentence transformers for embedding code snippets and retrieval
Code Repository Indexing — Automatically indexes code files from specified directories
Persistent Storage — Saves code embeddings in ChromaDB for persistent retrieval
Directory Exploration — Built-in tools for navigating and exploring codebases
Background Initialization — Loads resources asynchronously to minimize startup time
Environment Configuration — Configurable through environment variables

Configuration

Python 3.11 - Dependencies listed in pyproject.toml

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the WindTools MCP Server

{
  "mcpServers": {
    "windtools": {
      "command": "uvx",
      "args": [
        "-p",
        "3.11",
        "-U",
        "windtools-mcp"
      ],
      "env": {
        "DATA_ROOT": "/Users/<user>/windtools_data",
        "CHROMA_DB_FOLDER_NAME": "chromadb",
        "SENTENCE_TRANSFORMER_PATH": "jinaai/jina-embeddings-v2-base-code"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Python 3.11 - Dependencies listed in pyproject.toml

Variable	Description	Required
DATA_ROOT	Configuration value read at startup.	Optional
CHROMA_DB_FOLDER_NAME	Configuration value read at startup.	Optional
SENTENCE_TRANSFORMER_PATH	Filesystem location the server is allowed to use.	Optional