drio
Open app

WindTools MCP Server

Source

Your own codebase tools like code semantic search

Catalog onlyCatalog onlySTDIO

Overview

WindTools MCP Server is a code assistant that provides tools for semantic code search and document embedding using ChromaDB and sentence transformers.

To use the WindTools MCP Server, install it via pip or from source, configure the environment variables, and run the server. You can then utilize its tools for code indexing and searching.

  • Semantic Code Search: Leverages sentence transformers for embedding and retrieving code snippets. - Code Repository Indexing: Automatically indexes code files from specified directories. - Persistent Storage: Saves code embeddings in ChromaDB for persistent retrieval. - Directory Exploration: Tools for navigating and exploring codebases. - Background Initialization: Asynchronous loading of resources to minimize startup time.
  1. Searching for relevant code snippets in large codebases.
  2. Indexing and retrieving code files for better development efficiency.
  3. Assisting developers in navigating complex code structures.

Add to your AI client

Use these steps to connect WindTools MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "windtools-mcp-zahidgalea": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-windtools-mcp-zahidgalea"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "windtools-mcp-zahidgalea": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-windtools-mcp-zahidgalea"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "windtools-mcp-zahidgalea": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-windtools-mcp-zahidgalea"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "windtools-mcp-zahidgalea": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-windtools-mcp-zahidgalea"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "windtools-mcp-zahidgalea": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-windtools-mcp-zahidgalea"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "windtools-mcp-zahidgalea": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-windtools-mcp-zahidgalea"
      ]
    }
  }
}

FAQ

Can WindTools MCP Server be used with any programming language?

Yes! It can be configured to work with any language as long as the code files are indexed.

Is WindTools MCP Server free to use?

Yes! It is open-source and free to use under the MIT License.

How do I contribute to the WindTools MCP Server?

You can contribute by submitting issues or pull requests on the GitHub repository.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3024,"uuid":"b6e43e6f-0ce6-4b98-a19b-f6321132c873","name":"windtools-mcp","title":"WindTools MCP Server","description":"Your own codebase tools like code semantic search","avatar_url":"https://avatars.githubusercontent.com/u/39713883?v=4","created_at":"2025-03-17T02:30:11.461Z","updated_at":"2025-03-20T12:08:49.564Z","status":"created","author_name":"ZahidGalea","author_avatar_url":"https://avatars.githubusercontent.com/u/39713883?v=4","tags":"python,mcp,developer-tools,mcp-server","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/ZahidGalea/windtools-mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"1\",\"license\":\"\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-03-18 00:26:31\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools