F
licenseNot graded
qualityC
maintenanceExposes a secure, path-confined bridge to a local workspace and git remotes, enabling MCP clients to search, read, write, reset files, and perform git operations.
-
PersonalMCP
by hollanjs
Provides Git inspection and repository operations within the approved workspace when Git is available and the workspace is a Git repository.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PersonalMCPsearch the workspace for TODO comments and list them by file"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PersonalMCP
A local Python MCP server that gives an MCP client (VS Code, Copilot CLI) read/write access to one approved workspace: file and directory CRUD, search, git, shell commands, Python tooling, data conversion, web fetch, HTTP testing, system diagnostics and a todo list (68 tools). It uses the official MCP Python SDK over stdio and does not invoke an LLM. All tools run under one security model: workspace confinement, protected-name denylist, secret redaction, hashed audit logging, size/time limits, and an optional operator policy. Set read_only for inspection only, or allow_commands=false to disable process execution. Tool groups are documented at docs://tools (or the get_tool_docs tool) and in src/personal_mcp/toolkit/resources.
Requirements
Python 3.11 or newer
Git is optional; Git inspection is disabled when it is unavailable or the workspace is not itself a repository
Install from the release ZIP for an offline installation, or install the pinned project dependencies from PyPI
Related MCP server: Cloud Harness MCP
Run from a checkout
python -m pip install .
python -m personal_mcp --workspace C:\path\to\workspace servepython -m pip install .
python -m personal_mcp --workspace "$HOME/project" serveThe server defaults to the current directory when no workspace is supplied. Configuration can be passed as JSON with --config; MCP_WORKSPACE_ROOT is the only supported environment override. See docs/configuration.md.
Administration
python -m personal_mcp --version
python -m personal_mcp validate-config
python -m personal_mcp self-test
python -m personal_mcp print-client-config
python -m personal_mcp diagnostics
python -m personal_mcp capability-manifestSee docs/installation.md, docs/security-and-guardrails.md, and docs/compatibility.md before deployment. Manual GitHub Copilot and VS Code validation is documented in tests/manual/github-copilot-vscode-validation.md.
Development
python -m unittest discover -s tests -v
python scripts/validate/validate_docs.py
python scripts/build/build_release.pyThis project is not affiliated with or an extension to GitHub Copilot or Visual Studio Code. See SECURITY.md for vulnerability reporting.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues
Related MCP Connectors
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Read and write shared BitsWeave context, projects, tasks, and work sessions through MCP.
One MCP endpoint for your company's tools, with per-person sign-in, policy and audit.
Query, browse, and automate OmegaAI workspaces from any MCP client. Streamable HTTP with OAuth 2.0.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI clients to securely operate isolated coding workspaces with file, command, Git, and deployment tools via authenticated remote MCP.95MIT
- AlicenseAqualityBmaintenanceEnables MCP clients to safely read, write, edit, search, and optionally run commands within one or more named project workspaces, while maintaining a work journal and tracking changes.19MIT
- AlicenseNot gradedqualityCmaintenanceEnables managed access to workspace file operations, background tasks, Skills, and upstream MCP services through a unified web console with workspace-bound keys and explicit tool permissions.MIT