windtools-mcp 0.0.3

A Codebase MCP Tools

WindTools MCP Server

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

Features

• Semantic Code Search: Uses sentence transformers for embedding code snippets and retrieval
• Persistent Storage: Saves code embeddings in ChromaDB for persistent retrieval
• Directory Exploration: Built-in tools for navigating and exploring codebases
• Environment Configuration: Configurable through environment variables

Tools

1. list_dir
   • List the contents of a directory
   • Inputs:
     • directory_path (string): Path to list contents of, should be absolute path to a directory
   • Returns: String with directory listing including file types and sizes

Technical Architecture

The WindTools MCP Server is built on these key components:

• ChromaDB: Vector database for storing and retrieving code embeddings
• Sentence Transformers: Deep learning models for creating embeddings from code
• FastMCP: Framework for building MCP-compliant servers
• Async Lifespan Management: Efficient resource initialization and cleanup

Setup

Environment Variables

The server can be configured with the following environment variables:

• DATA_ROOT: Directorio base donde se almacenarán todos los datos (por defecto: /app/data)
• CHROMA_DB_FOLDER_NAME: Name of the folder where ChromaDB stores data (default: "default")
• SENTENCE_TRANSFORMER_PATH: Path to the sentence transformer model (default: "jinaai/jina-embeddings-v2-base-code")

Installation

Using pip

pip install windtools-mcp

From source

git clone <repository-url>
cd windtools-mcp
pip install -e .

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Direct Execution

{
  "mcpServers": {
    "windtools": {
      "command": "uvx",
      "args": [
        "windtools-mcp"
      ],
      "env": {
        "DATA_ROOT": "~/windtools_data",
        "CHROMA_DB_FOLDER_NAME": "chromadb",
        "SENTENCE_TRANSFORMER_PATH": "jinaai/jina-embeddings-v2-base-code"
      }
    }
  }
}

Los datos (incluyendo la base de datos ChromaDB y el caché de modelos) se guardarán en el directorio ~/windtools_data y persistirán entre ejecuciones del contenedor.

Development

Requirements

• Python 3.10.13 or higher
• Dependencies listed in pyproject.toml

Development Setup

# Create a virtual environment (optional but recommended)
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install development dependencies
uv sync --dev

Running Tests

pytest tests/

Project Structure

src/
  windtools_mcp/
    __init__.py
    __main__.py
    server.py
tests/
  test_client.py
.gitignore
.python-version
pyproject.toml

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.