# Clone the repository
git clone https://github.com/yourusername/mcp-server-template.git
cd mcp-server-template

# Install dependencies
pip install -r requirements.txt

# Copy environment template
cp .env.example .env

# Backend API Configuration
API_BASE_URL=http://your-api-server:port

# Server Configuration
PORT=8001

# Logging
LOG_LEVEL=INFO

python server.py

mcp-server-template/
├── server.py          # MCP server entry point
├── config.py          # Configuration and logging
├── middleware.py       # Authentication middleware
├── constants.py       # Constants definition
├── utils.py           # Utility functions
├── tools/             # Tools module directory
│   ├── __init__.py    # Tools module initialization
│   ├── example.py     # Example tools
│   └── ...            # Add your tools here
├── docs/              # Documentation
│   ├── README.md      # This file
│   └── API.md         # API documentation
├── .env.example       # Environment variables template
├── requirements.txt   # Python dependencies
└── LICENSE            # MIT License

{
  "mcpServers": {
    "your-server-name": {
      "url": "http://localhost:8001/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

# tools/your_tool.py

from utils import call_api, check_response

def register_your_tools(mcp):
    """Register your tools to MCP server"""

    @mcp.tool()
    async def your_tool_name(param1: str = "", param2: int = 0) -> str:
        """Tool description for AI to understand when to use it.

        Args:
            param1: Description of param1
            param2: Description of param2

        Returns:
            Description of return value
        """
        # Call your backend API
        res = await call_api("/api/your-endpoint", body={
            "param1": param1,
            "param2": param2
        })

        # Check response
        ok, result = check_response(res, "your action")
        if not ok:
            return f"❌ {result}"

        # Process and return result
        return f"✅ Success: {result}"

from tools.your_tool import register_your_tools

def register_all_tools(mcp):
    """Register all tools to MCP server"""
    register_your_tools(mcp)

@mcp.resource("your-server://resource-name")
async def get_resource():
    """Resource description"""
    return {"key": "value"}