PersonalMCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_WORKSPACE_ROOT | No | The only supported environment override; sets the workspace root. The server defaults to the current directory when no workspace is supplied. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| server_healthB | Return safe server health, version, configuration state, and diagnostics status. |
| workspace_infoA | Return an opaque workspace identifier and active safety limits. |
| list_directoryC | List one workspace directory. Use cursor for the next bounded page. |
| get_file_metadataB | Return safe metadata for one file without reading its contents. |
| read_text_fileC | Read a bounded UTF-8 excerpt from an approved workspace file. |
| search_workspace_textC | Search bounded text files and return sanitized line excerpts. |
| summarize_project_structureC | Return a shallow, bounded inventory without reading file contents. |
| git_repository_statusB | Return bounded read-only Git status; no untracked filenames are enumerated. |
| git_recent_historyB | Return a bounded list of recent commit summaries. |
| git_diff_summaryA | Return bounded diff statistics without patch contents. |
| get_capability_helpA | Return the capability inventory or one capability's manifest entry. |
| validate_server_configurationB | Validate the loaded configuration without returning machine-specific paths. |
| create_diagnostic_bundleB | Write a sanitized local diagnostic summary to the approved diagnostics directory. |
| create_fileB | Create a file (and parent dirs) with the given content. Writes are atomic. |
| edit_fileA | Replace old_string with new_string in a file. Fails unless it matches exactly once (or replace_all is true). dry_run=true returns a unified diff without writing. |
| edit_file_multiA | Apply several edits atomically. Each edit is {"old_string": ..., "new_string": ..., optional "replace_all": "true"}. Edits apply in order; if any fails nothing is written. |
| replace_linesA | Replace lines start_line..end_line (1-based, inclusive) with new_text. Use end_line=start_line-1 to insert before start_line. |
| create_directoryC | Create a directory and any missing parents. Succeeds if it already exists. |
| delete_fileA | Delete a file or directory (recursively). Irreversible. Refuses the workspace root, trees that contain links, nested repositories or protected files, and huge trees. |
| move_pathB | Move or rename a file or directory inside the workspace. Never overwrites. |
| copy_pathB | Copy a file or directory inside the workspace. Never overwrites. |
| grepA | Regex search file contents. Returns path:line: text matches. Skips git-ignored files (and .git, node_modules, .venv) unless respect_gitignore=false. Use offset to page. |
| globA | Find files by glob pattern (e.g. '**/*.py'), relative to path. Skips git-ignored files unless respect_gitignore=false. Use offset to page. |
| run_commandA | Run a shell command and return exit code, stdout and stderr. Uses PowerShell on Windows and the default shell elsewhere. The working directory must be inside the workspace (default: the workspace root). The command itself is NOT confined: a shell can still reach any path the server's user can. Secret-named environment variables are removed and output is redacted. |
| git_statusC | Show short git status. |
| git_diffB | Show git diff (optionally staged and/or for one path). |
| git_logC | Show recent commits. |
| git_addC | Stage files. |
| git_commitC | Commit staged changes. |
| git_initB | Initialise a new git repository (non-destructive; existing repos are left intact). |
| git_branch_createA | Create a new branch (and optionally switch to it). Never overwrites an existing branch. |
| git_switchB | Switch to an existing branch. Git refuses if it would overwrite local changes. |
| git_tag_createB | Create a tag (annotated if message given). Never moves or replaces an existing tag. |
| git_pushA | Push a branch (default: current) to a remote. Force pushes and ref deletion are not supported. tags=true pushes tags instead of a branch. |
| git_blameB | Show who last changed each line of a file (read-only). Optionally limit to a line range. |
| git_showB | Show a commit's message and diff (read-only). stat_only=true gives only the file summary. |
| git_branch_listA | List branches with their last commit and upstream (read-only). all_branches includes remotes. |
| git_stash_listB | List stashes (read-only). |
| git_remote_infoA | List configured remotes and their URLs (read-only). Credentials in URLs are masked. |
| git_diff_statB | Summarise changes per file (read-only), compact for large diffs. base compares with a revision. |
| run_testsC | Run pytest on a path with optional extra args (e.g. '-k name -x'). |
| lintB | Lint Python code with ruff (optionally auto-fix). |
| format_codeB | Format Python code with ruff; check_only=True only reports. |
| web_fetchA | Download a web page (after explicit user confirmation), sanitise it and save it as a local markdown file. Returns the file path only; read the file to consume it. Executable/archive/ document extensions and non-text content types are rejected; scripts, forms, iframes, event handlers and unsafe links are stripped. Private/loopback addresses are blocked. |
| convert_dataA | Convert between json, yaml, toml, csv, xml and psd1 (PowerShell data files). Provide either path or text. from_format is inferred from the file extension when omitted. With output_path the result is written there; otherwise it is returned. Reading psd1 needs pwsh (restricted language mode, no code execution); XML uses @attr / #text conventions. |
| query_dataB | Extract values from a json/yaml/toml/csv/xml/psd1 file with a path expression such as 'servers[0].name', 'users[].email' or '.port'. Returns JSON (a list of matches). |
| script_to_markdownA | Convert a script into literate markdown: column-0 comment blocks (and PowerShell <# #> blocks) become prose, everything else becomes fenced code. Heuristic and meant for documentation; markdown_to_script reverses it. |
| markdown_to_scriptA | Extract code from a markdown file. Only fenced blocks tagged with |
| pandoc_convertB | Convert documents with pandoc (docx, html, md, rst, pdf output needs a LaTeX engine...). Runs in --sandbox mode so the document cannot read other files or run filters. |
| http_requestA | Send an HTTP request (localhost and private addresses allowed) and report status, timing, redacted headers and a truncated body. Optional assertions: expect_status, expect_json ({"data.items[0].id": 5} path->value), expect_contains (substring of body), max_latency_ms. Result begins with PASS/FAIL when assertions are given. |
| api_load_testA | Tiny load probe: send |
| system_infoA | OS, kernel, uptime, CPU, load, memory, swap and disk usage for this machine. |
| list_processesB | List processes (pid, name, user, cpu%, memory) sorted by 'memory' or 'cpu' or 'pid'. |
| list_portsB | List TCP/UDP sockets with owning process. May need elevated rights to see other users' PIDs. |
| network_interfacesA | NIC configuration: addresses, netmask, MAC, MTU, speed and up/down state, plus I/O counters. |
| dns_lookupB | Resolve a hostname to its addresses using the system resolver. |
| check_tcp_portB | Test whether a TCP connection to host:port succeeds, with connect time. |
| list_servicesB | List services (systemd on Linux, Get-Service on Windows, launchctl on macOS). state: e.g. running / stopped (Windows) or running / failed / active (systemd). |
| service_statusC | Detailed status of one service. |
| read_event_logsA | Recent system events. Linux: journalctl (source = unit name, level = minimum severity).
Windows: Get-WinEvent (source = log name, default 'System'; level = exact level).
macOS: |
| cim_queryA | Query CIM/WMI classes via Get-CimInstance (Windows only), e.g. Win32_OperatingSystem,
Win32_LogicalDisk, Win32_NetworkAdapterConfiguration, Win32_Service. |
| environment_variablesB | Environment variables of the server process. Values of secret-looking names are redacted. |
| todo_listA | List the workspace todo scratchpad. Optional status filter: pending, in_progress, done. |
| todo_addA | Add a todo (status pending) to the workspace scratchpad and return the updated list. |
| todo_updateA | Change a todo's status (pending, in_progress, done) and/or text; returns the updated list. |
| todo_removeA | Remove one todo from the scratchpad by id; returns the updated list. |
| policy_infoA | Show whether an operator policy file exists and its contents (allow/deny lists, command deny patterns, web_fetch domain allow-list). |
| get_tool_docsA | Return usage docs and examples for a toolkit group (filesystem, search, shell, git, python, web-fetch, data-conversion, api-testing, diagnostics, todo, policy) or 'index'. Call this after a tool error. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| inspect_workspace | Guide a staged, low-risk workspace inspection. |
| understand_project | Guide concise project-structure and documentation review. |
| troubleshoot_server | Guide safe local server troubleshooting. |
| choose_tool | Route a request to the least-privileged capability. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| capability_index | |
| tool_documentation_index | |
| prompt_documentation_index | |
| resource_documentation_index | |
| skill_documentation_index | |
| security_summary | |
| configuration_reference | |
| troubleshooting_guide | |
| release_information | |
| compatibility_information | |
| known_limitations | |
| toolkit_index | Index of toolkit groups and rules that apply to every tool. |
TDQS
Scored across 68 tools
Tools are grouped into clear domains, but several within-domain pairs overlap heavily: git_status vs git_repository_status, git_log vs git_recent_history, and git_diff vs git_diff_summary vs git_diff_stat. Descriptions help distinguish bounded/read-only variants, but an agent could still easily misselect among them.
All names are snake_case, which is consistent, but the structural convention is mixed: verb_noun (list_directory, read_text_file), noun_verb (todo_list, git_status), and noun_noun (service_status, git_repository_status) all appear. The domain prefixes help readability, but there is no single predictable pattern.
With 68 tools, the surface is extremely large even for a broad personal automation server, and several tools duplicate existing read-only git functionality. This is squarely in the 50+ extreme-count range and makes discovery and selection harder.
The server covers filesystem, search, shell, Python tooling, git, data conversion, web/API testing, diagnostics, todos, and system inspection with broad lifecycle support. The main gaps are git network/workflow operations such as clone/fetch/pull/merge and service or process control, though run_command provides a workaround.