MCP (Model Context Protocol) Server for py4agent - Provides code execution capabilities through Jupyter kernels
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"py4agent-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# py4agent-mcp MCP (Model Context Protocol) Server for py4agent - Provides code execution capabilities through Jupyter kernels. ## Features - **Isolated Python Runtimes**: Create and manage independent Python execution environments - **MCP Protocol Integration**: Seamless integration with Model Context Protocol - **Jupyter Kernel Backend**: Powered by Jupyter Server's kernel management - **Multi-modal Output**: Support for text, tables, plots, and images - **Background Execution**: Async code execution for long-running operations - **Runtime Persistence**: Automatic save/restore of runtime configurations ## Installation This project is part of a monorepo. Install dependencies: ```bash # Install py4agent (required dependency) pip install py4agent # Install py4agent-mcp cd py4agent-mcp pip install -e . ``` For development setup, see [INSTALL.md](INSTALL.md). ## Usage ### Start the MCP Server ```bash # Start with default settings (127.0.0.1:8889) py4agent-mcp # Custom host and port py4agent-mcp --host 0.0.0.0 --port 9000 # Enable debug logging py4agent-mcp --debug # Save logs to file py4agent-mcp --log-dir ./logs ``` ### Command Line Options - `--host`: Host to bind (default: 127.0.0.1) - `--port`: Port to bind (default: 8889) - `--debug`: Enable debug logging - `--workers`: Number of worker processes (must be 1 for MCP) - `--log-dir`: Directory to store logs (optional) ### Python API ```python from py4agent_mcp import create_app, create_mcp_app, main from py4agent_mcp.mcp_server import JupyterKernelManager # Create FastAPI app with MCP mounted app = create_app() # Create MCP server app mcp_app = create_mcp_app() # Run the server main() ``` ## MCP Tools The server exposes the following MCP tools: 1. **create_runtime**: Create a new isolated Python runtime 2. **list_runtimes**: List all active runtimes 3. **delete_runtime**: Delete a runtime and free resources 4. **restart_runtime**: Restart a runtime (clears state) 5. **interrupt_runtime**: Int…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.