AI导哈

本地开发辅助工具

一个简单的本地MCP服务器，允许Claude Desktop读取、列出和搜索项目文件夹中的文件，完全本地化且私密。

  • by MNabeelAltaf
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 MNabeelAltaf/Local-Dev-Assistant-MCP-Server

使用说明

Local Dev Assistant for Claude Desktop

A simple local MCP server that allows Claude Desktop to read, list, and search files in your project folder — completely locally and privately.

Perfect for asking questions about your own codebases (React, Next.js, Python, Laravel, NestJS.) without uploading anything anywhere.

Features

  • List all files in the project (with useful folders ignored)
  • Read the full content of any file
  • Search for keywords or text across all files
  • 100% local — no cloud, no data leaves your computer
  • Currently read-only (safe by default)

Project Structure

local-dev-assistant/ ├── myenv/ # Python virtual environment ├── your_project/ # ← Your actual codebase goes here ├── core/ │ ├── config.py │ ├── mcp_stdio.py # stdio transport patch (blank stdin lines) │ └── security.py ├── tools/ │ ├── file_tools.py │ └── search_tools.py ├── server.py # Main FastMCP server ├── .env.example # Project root configuration ├── requirements.txt └── README.md

Quick Setup

1. Prerequisites

  • Python 3.9+
  • Claude Desktop (with local MCP support)

2. Installation

# Create and activate virtual environment
python -m venv myenv
source myenv/Scripts/activate      # Windows

# Install required packages
pip install fastmcp python-dotenv

# (Optional) Save installed packages
pip freeze > requirements.txt


## Add your codebase in the `your_project` folder

Paste your codebase inside **`your_project/`** (in this repo). Point **`PROJECT_ROOT`** in `.env` at that folder.

your_project/
├── app/
│   └── page.tsx
├── components/
├── package.json
└── ...

## Run the server
source myenv/Scripts/activate
python server.py


## Connect in Claude Desktop

**Step-by-step:** see **[Guide-Setup.md](Guide-Setup.md)** in this repo.

Open Claude Desktop → **Settings → Developer → Edit Config** (`claude_desktop_config.json`), add the server under `mcpServers`, then fully quit and restart Claude. Use **tools / hammer** or **+ → Connectors** to confirm **Local Dev Assistant** is connected.

## Example questions to ask Claude
Show me all files in the project
...

*Streamble HTTP expose at /mcp*

相关 MCP