Python MCP Server

Name: Python MCP Server
Author: sisovin

@sisovin

About Python MCP Server

The **python-mcp-server** project is a Flask-based web server designed to interact with Minecraft, likely as part of a larger system for managing Minecraft servers, plugins, or player data.

#python-mcp-server #minecraft #flask

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "python-mcp-server-sisovin": {
      "command": "python",
      "args": [
        "server/main.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Python MCP Server?

Python MCP Server is a Flask-based web backend for Minecraft‑related applications, such as server management, user authentication, and plugin integration. It provides a web interface (HTML/Jinja2 templates) and RESTful API endpoints, and uses SQLAlchemy for database storage (SQLite/PostgreSQL). The project is intended for Minecraft server admins and developers who need a lightweight backend to handle player data, commands, or dashboards.

How to use Python MCP Server?

Install dependencies with pip install -r requirements.txt, then configure secrets in server/config.py. Start the Flask app with python server/main.py and access the web interface at http://localhost:5000. A task generator script (python server/task_generator.py) is also available for automatic coding plan generation using the OpenAI library.

Key features of Python MCP Server

User authentication (login/logout with Flask sessions)
Database integration via SQLAlchemy models
Web interface with Jinja2 templating and static assets
RESTful API endpoints for player data and server commands
Unit tests for auth, database, and utilities
Task generation using OpenAI API

Use cases of Python MCP Server

Build a Minecraft server dashboard for admins to monitor and manage instances
Track and display player statistics, achievements, and ranks
Act as a backend for Minecraft plugins (economy, permissions, etc.)
Automate task generation for development planning based on project structure

FAQ from Python MCP Server

What does Python MCP Server do?

It is a Flask web server that provides a web interface and API endpoints to interact with Minecraft services, including user authentication, database storage of player data, and server command execution.

What are the runtime dependencies?

Python 3, Flask, SQLAlchemy, Jinja2, pytest/unittest, and the OpenAI library (for task generation). Database can be SQLite or PostgreSQL. No WebSocket or real‑time features are included.

How do I start the server?

Install dependencies, configure server/config.py, then run python server/main.py. The web interface will be available at http://localhost:5000.

Is this a complete Minecraft plugin?

No. This repo contains only the backend server. A separate Spigot/Bukkit plugin would be needed to communicate with it for full Minecraft integration.

Where is user data stored?

Data is stored in a database managed by SQLAlchemy (SQLite by default, but configurable to PostgreSQL). Models are defined in server/database/models.py.