MCP Data Server

# 1) Clone and enter project git clone https://github.com/hkonda015/McpServer.git Set-Location .\McpServer\McpServer # 2) Create & activate venv (PowerShell) python -m venv .venv .\.venv\Scripts\Activate.ps1 # 3) Install runtime (or dev) dependencies pip install -r requirements.txt # or for contributors: pip install -r requirements-dev.txt # 4) (Optional) pre-commit hooks pre-commit install # 5) Put a few files in .\data\ (txt/pdf/csv/md), then: python -m mcp_data_server ls python -m mcp_data_server index python -m mcp_data_server search "your query" --k 5 ## Usage (CLI) The CLI lets you **list files**, **build/rebuild the index**, and **search** your local documents. > **Prereq:** open a terminal at your repo root and activate the venv > Windows (PowerShell): > ```powershell > Set-Location .\McpServer > .\.venv\Scripts\Activate.ps1 > ``` > macOS/Linux (bash): > ```bash > cd McpServer > source .venv/bin/activate > ``` --- ### 1) List files (`ls`) Lists all **supported documents** under `DATA_DIR` (defaults to `./data`). ```powershell python -m mcp_data_server ls # Contributing to MCP Data Server Thanks for your interest in contributing! This document explains how to set up your dev environment, the coding standards we use, how to run tests, and how to submit a good pull request. --- ## Ways to contribute - **Bug reports**: include steps to reproduce, expected vs actual behavior, OS, Python version, and logs. - **Feature requests**: explain the use case, not just the solution. Sketch CLI and/or MCP tool UX if relevant. - **Documentation**: improve READMEs, examples, and comments. - **Code**: bug fixes, new loaders, chunking strategies, performance improvements, tests. Good first issues will be labeled **good first issue** and **help wanted**. --- ## Development setup ### Prerequisites - Python **3.11+** (we recommend 3.11) - Git - ~3 GB free disk space for model cache on first run ### Clone and create a virtual environment #### Windows (PowerShell) ```powershell git clone https://github.com/hkonda015/McpServer.git Set-Location .\McpServer\McpServer python -m venv .venv .\.venv\Scripts\Activate.ps1 pip install -r requirements-dev.txt pre-commit install