dev-kit-mcp-server 0.0.1b0

A Model Context Protocol server for turning repositories into navigable MCP systems

Dev-Kit MCP Server

A Model Context Protocol (MCP) server for interacting with codebases. This package provides tools for turning any repository or code base into an MCP system.

Features

• 🔌 MCP Integration: Turn any codebase into an MCP-compliant system
• 🛠️ Custom Tools: Create custom tools for specific repository needs
• 🔍 Repository Navigation: Navigate and explore code repositories with ease
• 🧩 Code Structure Analysis: Understand code structure through AST analysis
• 🔢 Code Exploration: Explore code elements like functions, classes, and imports
• 🚀 Fast API: Built with FastAPI for high performance

Installation

pip install dev-kit-mcp-server

Usage

Running the Server

# Recommended method (with root directory specified)
dev-kit-mcp-server --root-dir=workdir

# Alternative methods
uv run python -m dev_kit_mcp_server.mcp_server --root-dir=workdir
python -m dev_kit_mcp_server.mcp_server --root-dir=workdir

The --root-dir parameter specifies the directory where file operations will be performed. This is important for security reasons, as it restricts file operations to this directory only.

API Endpoints

• GET /: Repository navigation server information
• POST /analyze: Comprehensive repository structure analysis
• POST /ast: Code structure extraction for navigation
• POST /tokenize: Detailed code element identification
• POST /count: Repository component summarization

Get repository structure for navigation

response = requests.post( "http://localhost:8000/analyze", json={"code": code, "path": "src/data/navigator.py"} )

Use the structure for repository navigation

structure = response.json() print(f"Repository components found: {len(structure['result']['ast_analysis']['functions'])} functions, " f"{len(structure['result']['ast_analysis']['classes'])} classes")

## Development

### Setup

```bash
# Clone the repository
git clone https://github.com/DanielAvdar/dev-kit-mcp-server.git
cd dev-kit-mcp-server

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.