# {{ server_name }}

{{ description }}

## Quick Start

```bash
# Install dependencies
uv sync

# Run the server (streamable HTTP transport)
{{ server_name }}

# Or with custom host/port
MCP_HOST=0.0.0.0 MCP_PORT=9000 {{ server_name }}
```

The server will start at `http://127.0.0.1:8000/mcp` by default.

## Testing

```bash
# Run tests with hdx
hdx server test
```

## Project Structure

```
{{ server_name }}/
├── src/
│   └── {{ python_package }}/
│       ├── __init__.py
│       └── server.py      # MCP server and tool definitions
├── tests/
│   └── fixtures/
│       └── test_tools.yaml # Test fixtures for hdx server test
├── pyproject.toml
└── README.md
```

## Adding Tools

Add new tools in `src/{{ python_package }}/server.py`:

```python
@mcp.tool(
    annotations={
        "title": "My New Tool",
        "readOnlyHint": True,
    }
)
def {{ tool_prefix }}_my_tool(arg: str) -> str:
    """Describe what the tool does.

    Args:
        arg: Describe the argument.
    """
    return f"Result: {arg}"
```

## MCP Configuration

To use this server with Claude Desktop, add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "{{ service_name }}": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}
```
