dev-kit MCP server
Commit Nov 12, 2026Enables AI agents to perform secure file operations, Git commands, and Makefile execution within a scoped project directory.
Also known as DanielAvdar/dev-kit-mcp-server
- Stars
- 6
- Tools
- 17
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 12, 2026
- License
- MIT
What is dev-kit MCP?
dev-kit enables AI agents to perform secure file operations, Git commands, and Makefile execution within a scoped project directory. It exposes 17 tools, such as create_dir, edit_file, move_dir.
Summary generated from the project's README
About dev-kit MCP server
Managing codebases and executing development workflows through AI agents is what this server enables. It provides a secure environment for AI-assisted development tools, such as VS-Code copilot, to interact with a specific project directory. By defining a root directory via the --root-dir parameter, the server ensures that all file and command operations remain strictly within authorized boundaries.
Developers can use this tool to perform a wide range of tasks including file manipulation, Git version control, and Makefile execution. It includes specific tools for creating, moving, renaming, and deleting files, as well as managing branches and commits through git_status, git_add, and git_push. The server also supports running predefined commands from a TOML file, allowing for custom workflows like running tests or linters. This makes it a versatile bridge for turning any codebase into an MCP-compliant system for autonomous agents.
What you can do with it
- 1Automated Git Version ControlAn AI agent can manage repository states by staging files, committing changes, and pushing to remote branches.
- 2Secure File System ManagementA developer can task an AI with organizing a project by moving, renaming, or deleting specific files within a scoped directory.
- 3Executing Build and Test WorkflowsYou can instruct an AI to run specific build targets or predefined development commands defined in a configuration file.
- 4Codebase Exploration and SearchingAn AI can locate specific functions or files by searching through the project using regex patterns and text matching.
Written from the project's README. Every use case is checked against a quote from it.
dev-kit MCP tools 17
Detected from the READMEcreate_diredit_filemove_dirremove_filerename_filegit_statusgit_addgit_commitgit_pushgit_pullgit_checkoutgit_diff
Show all 17 toolsShow fewer tools
exec_make_targetsearch_filessearch_textread_linespredefined_commands
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabledanielavdar/dev-kit-mcp-server is public and reachablegithub.com/danielavdar/dev-kit-mcp-server ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/danielavdar/dev-kit-mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubDev-Kit MCP Server
A Model Context Protocol (MCP) server targeted for agent development tools, providing scoped authorized operations in the root project directory. This package enables secure execution of operations such as running makefile commands, moving and deleting files, with future plans to include more tools for code editing. It serves as an excellent MCP server for VS-Code copilot and other AI-assisted development tools.
Features
- 🔒 Secure Operations: Execute operations within a scoped, authorized root directory
- 🛠️ Makefile Command Execution: Run makefile commands securely within the project
- 📁 File Operations: Move, Create, Rename and Delete files within the authorized directory
- 🔄 Git Operations: Perform Git operations like status, add, commit, push, pull, and checkout
- 🔌 MCP Integration: Turn any codebase into an MCP-compliant system
- 🤖 AI-Assisted Development: Excellent integration with VS-Code copilot and other AI tools
- 🔄 Extensible Framework: Easily add new tools for code editing and other operations
- 🚀 Fast Performance: Built with FastMCP 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
# With custom TOML file for predefined commands
dev-kit-mcp-server --root-dir=workdir --commands-toml=custom_commands.toml
# 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.
The --commands-toml parameter allows you to specify a custom TOML file for predefined commands instead of using the default pyproject.toml file. This is useful when you want to define a separate set of commands for different purposes.
Available Tools
The server provides the following tools:
File Operations
- create_dir: Create directories within the authorized root directory
- edit_file: Edit files by replacing lines between specified start and end lines with new text
- move_dir: Move files and directories within the authorized root directory
- remove_file: Delete files within the authorized root directory
- rename_file: Rename files and directories within the authorized root directory
Git Operations
- git_status: Get the status of the Git repository (changed files, untracked files, etc.)
- git_add: Add files to the Git index (staging area)
- git_commit: Commit changes to the Git repository
- git_push: Push changes to a remote Git repository
- git_pull: Pull changes from a remote Git repository
- git_checkout: Checkout or create a branch in the Git repository
- git_diff: Show diffs between commits, commit and working tree, etc.
Makefile Operations
- exec_make_target: Run makefile commands securely within the project
Exploration Operations
- search_files: Search for files by regex pattern in the project directory. Supports optional root directory and output length limits.
- search_text: Search for lines in files matching a given pattern. Supports file filtering, context lines, and output length limits.
- read_lines: Read specific lines or a range from a file. Supports line range selection and output length limits.
Predefined Commands
- predefined_commands: Execute predefined commands from a TOML file (default: pyproject.toml under [tool.dkmcp.commands] section)
The TOML file format for predefined commands is as follows:
[tool.dkmcp.commands]
test = "uv run pytest"
lint = "ruff check"
check = "uvx pre-commit run --all-files"
doctest = "make doctest"
Each command is defined as a key-value pair where the key is the command name and the value is the command to execute. For example, when you call the predefined command "test", it will execute "uv run pytest" in the root directory.
Here's a simple example of how to define commands in a custom TOML file:
# custom_commands.toml
[tool.dkmcp.commands]
# Basic commands
hello = "echo Hello, World!"
date = "date"
# Development commands
test = "pytest"
lint = "ruff check ."
build = "python setup.py build"
Example Usage with MCP Client
from fastmcp import Client
async def example():
async with Client() as client:
# List available tools
tools = await client.list_tools()
# File Operations
# Create a directory
result = await client.call_tool("create_dir", {"path": "new_directory"})
# Move a file
result = await client.call_tool("move_dir", {"path1": "source.txt", "path2": "destination.txt"})
# Remove a file
result = await client.call_tool("remove_file", {"path": "file_to_remove.txt"})
# Rename a file
result = await client.call_tool("rename_file", {"path": "old_name.txt", "new_name": "new_name.txt"})
# Edit a file
result = await client.call_tool("edit_file", {
"path": "file_to_edit.txt",
"start_line": 2,
"end_line": 4,
"text": "This text will replace lines 2-4"
})
# Git Operations
# Get repository status
result = await client.call_tool("git_status")
# Add files to the index
result = await client.call_tool("git_add", {"paths": ["file1.txt", "file2.txt"]})
# Commit changes
result = await client.call_tool("git_commit", {"message": "Add new files"})
# Pull changes from remote
result = await client.call_tool("git_pull", {"remote": "origin", "branch": "main"})
# Push changes to remote
result = await client.call_tool("git_push")
# Checkout a branch
result = await client.call_tool("git_checkout", {"branch": "feature-branch", "create": True})
# Makefile Operations
# Run a makefile command
result = await client.call_tool("exec_make_target", {"commands": ["test"]})
# Exploration Operations
# Search for Python files
result = await client.call_tool("search_files", {"pattern": ".*\\.py$"})
# Search for files in a specific directory with output limit
result = await client.call_tool("search_files", {
"pattern": "test.*",
"root": "tests",
"max_chars": 1000
})
# Search for text patterns in files
result = await client.call_tool("search_text", {"pattern": "def.*test"})
# Search in specific files with context
result = await client.call_tool("search_text", {
"pattern": "import",
"files": ["main.py", "utils.py"],
"context": 2
})
# Read specific lines from a file
result = await client.call_tool("read_lines", {"file_path": "README.md", "start": 1, "end": 10})
# Read entire file with character limit
result = await client.call_tool("read_lines", {
"file_path": "config.json",
"max_chars": 500
})
# Predefined Commands
# Execute a predefined command
result = await client.call_tool("predefined_commands", {"command": "test"})
# Execute a predefined command with a parameter
result = await client.call_tool("predefined_commands", {"command": "test", "param": "specific_test"})
Development
Setup
# 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.
dev-kit MCP questions
What tools does dev-kit MCP provide?
It exposes 17 tools, including create_dir, edit_file, move_dir, remove_file, rename_file.
How does the server ensure security during file operations?
The server uses a --root-dir parameter to restrict all file operations to a specific, authorized directory.
Can I use custom commands instead of the default ones?
Yes, you can provide a custom TOML file using the --commands-toml parameter to define your own set of predefined commands.
What kind of Git operations are supported?
The server supports status, adding files, committing, pushing, pulling, checking out branches, and viewing diffs.
