mcp-switchboard-server-harness 0.3.0.dev3__tar.gz

mcp_switchboard_server_harness-0.3.0.dev3/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.pyc
+*.egg-info/
+.venv/
+venv/
+build/
+dist/
+# ...except the console's, which is committed on purpose: the hub embeds it, so
+# `go build` has to work without npm (spec.md U1). CI rebuilds it and fails if
+# this copy is stale.
+!hub/web/dist/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.env
+result
+result-*
+.direnv/

mcp_switchboard_server_harness-0.3.0.dev3/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.5
+Name: mcp-switchboard-server-harness
+Version: 0.3.0.dev3
+Summary: A stdio MCP server exposing filesystem, git and shell tools for coding agents
+Author: Akos Papp
+License: MIT
+Keywords: coding-agent,mcp,model-context-protocol,switchboard
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: mcp<3,>=2.2
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == 'test'
+Description-Content-Type: text/markdown
+
+# mcp-switchboard-server-harness
+
+A first-party stdio MCP server that gives a coding agent the basics on a
+remote machine: filesystem, search, git and shell tools. It is a normal MCP
+server, so [mcp-switchboard-client](../../client) tunnels it like any other.
+
+Tools (24; full schemas and behaviour in [spec.md](../../spec.md#4-harness-server)):
+
+- **Files:** `file_read` (paged), `file_write`, `file_delete`, `file_move`, `dir_list`, `tree_of_files`,
+  `find_files` (honours `.gitignore`), `ripgrep`, `read_lines`, `edit_file`
+- **Run:** `run_command`, `run_python`, and `process_start` / `process_read` / `process_kill` for
+  long-running work
+- **Git:** `git_status`, `git_diff`, `git_show`, `git_log`, `git_branch`, `git_add`, `git_checkout`,
+  `git_commit`, `git_push`
+
+Every tool carries read-only / destructive annotations, output is capped and always flagged when
+truncated, and commands run under a timeout that kills their whole process group.
+
+File tools are confined to a **root** (default: the directory the client started in). Change it with
+`--root DIR` or `MCP_SWITCHBOARD_HARNESS_ROOT`; `--root /` lifts it. Cap output with `--max-output N`
+or `MCP_SWITCHBOARD_HARNESS_MAX_OUTPUT`.
+
+## Use
+
+`mcp-switchboard-client` runs it by default as a server named `harness`; nothing to
+configure (`--no-harness` turns it off). To run it standalone or pin your own
+entry, add it to the `mcp.json` next to the client:
+
+```json
+{
+  "mcpServers": {
+    "harness": { "command": "uvx", "args": ["mcp-switchboard-server-harness"] }
+  }
+}
+```
+
+or run it directly: `mcp-switchboard-server-harness --name harness`.
+
+## Security
+
+The root only confines the *file* tools; `run_command`, `run_python` and `process_start`
+still run arbitrary commands as the user that started the client. It is a guard against mistakes
+and path tricks, not a sandbox. Keep the hub's private listener unexposed, or
+set `MCP_SWITCHBOARD_PRIVATE_TOKEN`.

mcp_switchboard_server_harness-0.3.0.dev3/README.md

@@ -0,0 +1,44 @@
+# mcp-switchboard-server-harness
+
+A first-party stdio MCP server that gives a coding agent the basics on a
+remote machine: filesystem, search, git and shell tools. It is a normal MCP
+server, so [mcp-switchboard-client](../../client) tunnels it like any other.
+
+Tools (24; full schemas and behaviour in [spec.md](../../spec.md#4-harness-server)):
+
+- **Files:** `file_read` (paged), `file_write`, `file_delete`, `file_move`, `dir_list`, `tree_of_files`,
+  `find_files` (honours `.gitignore`), `ripgrep`, `read_lines`, `edit_file`
+- **Run:** `run_command`, `run_python`, and `process_start` / `process_read` / `process_kill` for
+  long-running work
+- **Git:** `git_status`, `git_diff`, `git_show`, `git_log`, `git_branch`, `git_add`, `git_checkout`,
+  `git_commit`, `git_push`
+
+Every tool carries read-only / destructive annotations, output is capped and always flagged when
+truncated, and commands run under a timeout that kills their whole process group.
+
+File tools are confined to a **root** (default: the directory the client started in). Change it with
+`--root DIR` or `MCP_SWITCHBOARD_HARNESS_ROOT`; `--root /` lifts it. Cap output with `--max-output N`
+or `MCP_SWITCHBOARD_HARNESS_MAX_OUTPUT`.
+
+## Use
+
+`mcp-switchboard-client` runs it by default as a server named `harness`; nothing to
+configure (`--no-harness` turns it off). To run it standalone or pin your own
+entry, add it to the `mcp.json` next to the client:
+
+```json
+{
+  "mcpServers": {
+    "harness": { "command": "uvx", "args": ["mcp-switchboard-server-harness"] }
+  }
+}
+```
+
+or run it directly: `mcp-switchboard-server-harness --name harness`.
+
+## Security
+
+The root only confines the *file* tools; `run_command`, `run_python` and `process_start`
+still run arbitrary commands as the user that started the client. It is a guard against mistakes
+and path tricks, not a sandbox. Keep the hub's private listener unexposed, or
+set `MCP_SWITCHBOARD_PRIVATE_TOKEN`.

mcp_switchboard_server_harness-0.3.0.dev3/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mcp-switchboard-server-harness"
+version = "0.3.0.dev3"
+description = "A stdio MCP server exposing filesystem, git and shell tools for coding agents"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Akos Papp" }]
+keywords = ["mcp", "model-context-protocol", "coding-agent", "switchboard"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = ["mcp>=2.2,<3"]
+
+[project.optional-dependencies]
+test = ["pytest>=8"]
+
+[project.scripts]
+mcp-switchboard-server-harness = "mcp_switchboard_server_harness.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_switchboard_server_harness"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

mcp_switchboard_server_harness-0.3.0.dev3/src/mcp_switchboard_server_harness/__init__.py

@@ -0,0 +1,3 @@
+"""A stdio MCP server exposing filesystem, git and shell tools for coding agents."""
+
+__version__ = "0.3.0"

mcp_switchboard_server_harness-0.3.0.dev3/src/mcp_switchboard_server_harness/__main__.py

@@ -0,0 +1,3 @@
+from .server import main
+
+main()