Stevearagonsite PythonServerMcp

🚀 Python MCP Server - Cryptocurrency Price Service

This project implements an MCP (Model Context Protocol) server that provides cryptocurrency price information. The server is built using Python and the MCP framework to create APIs that can be used by different clients.

🚀 Quick Start

Docker

Build the Docker image: docker build -t mcp/python-server-mcp -f Dockerfile .

Add the following content to your mcp.json file:

{
  "mcpServers": {
    "python-server-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-p",
        "8000:8000",
        "-e",
        "ENVIRONMENT",
        "-e",
        "COINMARKETCAP_API_KEY",
        "mcp/python-server-mcp"
      ],
      "env": {
        "ENVIRONMENT": "PRODUCTION",
        "COINMARKETCAP_API_KEY": "your-api-key"
      }
    }
  }
}

✨ Features

• Real-time cryptocurrency price retrieval
• Environment configuration (development, production, staging, local)
• CoinMarketCap API integration
• Docker container deployment

📦 Installation

Requirements

• Python 3.12+
• uv (package and virtual environment manager)
• Docker (optional, for container execution)

Using uv (Recommended)

# Clone the repository
git clone <repository-url>
cd PythonServerMcp

Create and activate a virtual environment using uv

uv venv
source .venv/bin/activate

Install dependencies

uv sync

🛠 Configuration

1. Create a .env file in the project root directory with the following variables:

ENVIRONMENT=DEV  # Options: LOCAL, DEV, STAGING, PROD
COINMARKETCAP_API_KEY=your_api_key_here

2. You can also create specific environment files for each environment:
   • .dev.env - Development environment
   • .staging.env - Staging environment
   • .prod.env - Production environment

💻 Usage Examples

Local Execution

python main.py

This will start the MCP server, which will listen for requests via standard input/output (stdio).

Using Docker

# Build the image
docker build -t test-mcp -f Dockerfile --platform linux/amd64 .

# Run the container
docker run -it test-mcp

📚 Documentation

Project Structure

.
├── main.py
└── src
    ├── __init__.py
    ├── core
    │   ├── common
    │   │   ├── crypto_schema.py
    │   │   └── schema.py
    │   ├── config.py
    │   ├── settings
    │   │   ├── __init__.py
    │   │   ├── base.py
    │   │   ├── development.py
    │   │   ├── environment.py
    │   │   ├── local.py
    │   │   ├── production.py
    │   │   └── staging.py
    │   └── utils
    │       ├── datetime.py
    │       ├── extended_enum.py
    │       ├── filename_generator.py
    │       ├── passwords.py
    │       ├── query_utils.py
    │       └── redis.py
    ├── mcp_server.py
    ├── resources
    │   ├── __init__.py
    │   └── coinmarketcap_resource.py
    ├── server.py
    ├── services
    │   ├── __init__.py
    │   └── coinmarketcap_service.py
    └── tools
        ├── __init__.py
        └── prices.py

Development

Adding a New Tool to the MCP Server

To add a new tool to the MCP server, follow these steps:

1. Define the function in the src/__init__.py file.
2. Register the tool in the main() function.
3. Document the tool using docstrings.

Example:

@server.add_tool
def my_new_tool(parameter1: str, parameter2: int) -> str:
    """
    Describe the functionality of the tool.
    
    Parameters:
        parameter1: Description of parameter 1
        parameter2: Description of parameter 2
        
    Returns:
        Description of the returned content
    """
    # Tool implementation
    return result