io.github.oleksii-donets/simple_mcp
A Test MCP server that provides tools, promts and resources
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
docker.io/d0nets/simple-mcp:0.0.4claude mcp add simple-mcp -e 'APP_TRANSPORT=STDIO' -- docker run -i --rm docker.io/d0nets/simple-mcp:0.0.4
{
"mcpServers": {
"simple-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/d0nets/simple-mcp:0.0.4"
],
"env": {
"APP_TRANSPORT": "STDIO"
}
}
}
}
Variables d'environnement
APP_TRANSPORTTransport type
docker.io/d0nets/simple-mcp:0.0.4claude mcp add simple-mcp -e 'APP_TRANSPORT=<APP_TRANSPORT>' -e 'APP_HOST=0.0.0.0' -e 'APP_PORT=8000' -- docker run -i --rm docker.io/d0nets/simple-mcp:0.0.4
{
"mcpServers": {
"simple-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/d0nets/simple-mcp:0.0.4"
],
"env": {
"APP_TRANSPORT": "<APP_TRANSPORT>",
"APP_HOST": "0.0.0.0",
"APP_PORT": "8000"
}
}
}
}
Variables d'environnement
APP_TRANSPORTobligatoire Transport typeAPP_HOSTServer hostAPP_PORTServer port
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
# Simple MCP Server (Python)
This project provides a minimal Model Context Protocol (MCP) server using Python. It exposes a single tool random_float that returns a random float in [0,1). The server supports multiple transport modes: STDIO (default), HTTP, and SSE.
Run locally
Default (STDIO transport)
uv run main.py
Server Environment Variables
| Variable | Purpose | Default |
|---|---|---|
| APP_TRANSPORT | Transport type (STDIO, HTTP, SSE) | STDIO |
| APP_HOST | Server host | 0.0.0.0 |
| APP_PORT | Server port | 8000 |
Docker
Build the image and run:
docker build -t simple-mcp .
Docker with different transports
# HTTP transport
docker run --rm -p 8000:8000 -e APP_TRANSPORT=HTTP simple-mcp
# SSE transport
docker run --rm -p 8000:8000 -e APP_TRANSPORT=SSE simple-mcp
# Custom port
docker run --rm -p 9000:9000 -e APP_TRANSPORT=HTTP -e APP_PORT=9000 simple-mcp
Test as a standalone app
Test using Postman
uv --directory <path_to_project_directory> run main.py
Test using Claude Desktop
{
"mcpServers": {
"simple_mcp": {
"command": "uv",
"args": [
"run",
"--directory",
"<path_to_project_directory>",
"main.py"
]
}
}
}
Test as a docker image
Test using Postman
docker run --rm -i simple-mcp
Test using Claude Desktop
{
"mcpServers": {
"simple_mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"simple-mcp"
]
}
}
}
Questions fréquentes
Qu'est-ce que io.github.oleksii-donets/simple_mcp ?
A Test MCP server that provides tools, promts and resources
Comment installer io.github.oleksii-donets/simple_mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add simple-mcp -e 'APP_TRANSPORT=STDIO' -- docker run -i --rm docker.io/d0nets/simple-mcp:0.0.4. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.oleksii-donets/simple_mcp ?
Oui. Il attend APP_TRANSPORT, à renseigner dans sa configuration.
io.github.oleksii-donets/simple_mcp est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient io.github.oleksii-donets/simple_mcp ?
Il est publié par oleksii-donets. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.