Basic MCP Server
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., "@Basic MCP Serverread the file /tmp/data.json"
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.
Basic MCP Server
A small MCP server built with the official
Python SDK (mcp 2.x). It exposes four tools that let an MCP client
(Claude Desktop, the MCP Inspector, etc.) work with the local file system,
run shell commands, and fetch web pages.
Tools
Tool | Description | Parameters |
| Reads the file at the specified path. |
|
| Creates a new file and writes the given content into it. Overwrites the file if it already exists. |
|
| Runs the given shell command and returns its output (stdout + stderr). |
|
| Fetches a URL with an HTTP GET request and returns the status code and the page source. |
|
All tools return plain strings. Failures are prefixed with ERROR:, successful
writes with INFO:.
Warning:
execute_commandruns arbitrary shell commands with the permissions of the user running the server. Only connect clients you trust.
Related MCP server: emcp
Requirements
Installation
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txtUsage
Run the server with the MCP Inspector (browser-based debugging UI):
mcp dev server.pyRun the server directly over stdio:
mcp run server.pyInstall the server into the Claude Desktop app:
mcp install server.pyThe server object is named mcp in server.py, so the CLI commands above
find it automatically.
Project layout
server.py # the MCP server and its tools
requirements.txt # dependencies
LICENSE # MIT licenseLicense
This server cannot be deployed
Maintenance
Related MCP Connectors
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
MCP server to assist with JxBrowser development.
Turn any public website into an MCP server for agents to search, read and navigate.
Host your MCP tool over streamable HTTP in one command.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceCustom MCP tools for local development that enable file system access, shell command execution, and web resource browsing. Designed for local use with safety considerations for potentially destructive operations.-
- FlicenseNot gradedqualityDmaintenanceMCP server providing filesystem operations, shell execution, and web search capabilities.-
- FlicenseAqualityDmaintenanceEnables listing, reading, and searching local files and directories through MCP tools.4-
- FlicenseAqualityCmaintenanceEnables users to access local files, manage persistent notes via CRUD, fetch URLs, inspect system information, and analyze or transform text through MCP tools.11-