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

# Install dependencies
pip install -e ".[dev]"

# Or with uv (recommended)
uv pip install -e ".[dev]"

cp .env.example .env
# Edit .env with your settings

# Development mode with auto-reload
python -m mcp_server

# Or using the CLI
mcp-server run --reload

# Production mode
mcp-server run --host 0.0.0.0 --port 8000

{
  "mcpServers": {
    "toolbridge": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "env": {
        "MCP_SERVER_HOST": "localhost",
        "MCP_SERVER_PORT": "8000"
      }
    }
  }
}

toolbridge-mcp-server/
├── mcp_server/           # Main MCP server package
│   ├── __init__.py
│   ├── server.py         # Core MCP server implementation
│   ├── tools/            # Built-in tools
│   │   ├── __init__.py
│   │   ├── filesystem.py
│   │   ├── web_search.py
│   │   ├── code_execution.py
│   │   └── api_client.py
│   ├── resources/        # Resource providers
│   │   ├── __init__.py
│   │   ├── filesystem.py
│   │   └── database.py
│   ├── prompts/          # Prompt templates
│   │   ├── __init__.py
│   │   └── templates.py
│   ├── auth/             # Authentication
│   │   ├── __init__.py
│   │   ├── api_key.py
│   │   └── jwt.py
│   ├── config.py         # Configuration management
│   ├── logging.py        # Structured logging
│   └── middleware/       # MCP middleware
│       ├── __init__.py
│       ├── auth.py
│       └── logging.py
├── agent/                # Agent integration layer
│   ├── __init__.py
│   ├── base.py
│   ├── orchestrator.py
│   └── tools.py
├── tests/                # Test suite
│   ├── unit/
│   ├── integration/
│   ├── fixtures/
│   └── conftest.py
├── docs/                 # Documentation
│   ├── index.md
│   ├── getting-started.md
│   ├── tools.md
│   ├── resources.md
│   └── deployment.md
├── docker/               # Docker configuration
│   ├── Dockerfile
│   ├── docker-compose.yml
│   └── docker-compose.dev.yml
├── sample_data/          # Sample data for testing
├── scripts/              # Utility scripts
├── .env.example          # Environment template
├── requirements.txt      # Production dependencies
├── pyproject.toml        # Build configuration
├── LICENSE               # MIT License
└── README.md             # This file

# Run all tests
pytest

# Run with coverage
pytest --cov=mcp_server --cov-report=html

# Run specific test file
pytest tests/unit/test_tools.py -v

# Format code
ruff format .

# Lint
ruff check .

# Type check
mypy mcp_server

# Pre-commit hooks
pre-commit install
pre-commit run --all-files

# mcp_server/tools/my_tool.py
from mcp_server.tools import tool
from pydantic import BaseModel

class MyToolInput(BaseModel):
    query: str
    limit: int = 10

@tool(
    name="my_tool",
    description="Description of what this tool does",
)
async def my_tool(input: MyToolInput) -> str:
    # Implementation here
    return f"Result for: {input.query}"

# Build
docker build -t toolbridge/mcp-server .

# Run
docker run -p 8000:8000 --env-file .env toolbridge/mcp-server

# Docker Compose
docker-compose up -d

kubectl apply -f k8s/