概览
What is mcp-server-test?
mcp-server-test is a sample MCP server built from the official MCP quickstart. It is configured as a weather server and is intended for testing MCP server setup with Python and pyenv.
How to use mcp-server-test?
Install Python 3.10 or higher using pyenv, then configure your MCP client with the full path to the Python interpreter and the server script (src/main.py) in the command and args fields. Example configuration is provided in the README.
Key features of mcp-server-test
- Requires Python 3.10 or higher.
- Uses pyenv for Python version management.
- Based on the official MCP Python quickstart.
- Includes troubleshooting for common path errors.
- Simple JSON configuration for MCP clients.
Use cases of mcp-server-test
- Testing MCP server setup locally.
- Learning how to configure an MCP server with custom Python paths.
- Debugging Python environment issues in MCP integrations.
FAQ from mcp-server-test
What Python version is required for mcp-server-test?
Python 3.10 or higher is required. The README uses Python 3.11.5 as an example.
Why does the error "spawn python ENOENT" occur?
The error means the python command is not found in the system PATH. The solution is to use the full path to the Python interpreter (e.g., from pyenv which python) in the MCP configuration.
How do I configure mcp-server-test in my MCP client?
Add an entry under mcpServers in your client settings, setting command to the full path of the Python interpreter and args to the full path of the server script (src/main.py).
What does mcp-server-test do?
Based on the official MCP quickstart it references, mcp-server-test serves weather alerts. The configuration key "weather" confirms it is a weather server.
Where does the server code come from?
The code is taken directly from the official MCP quickstart at https://modelcontextprotocol.io/quickstart/server.
