# Hello World MCP Server

A simple MCP server that demonstrates the basic functionality of the Model Context Protocol (MCP).

## Features

This server provides:

1. A static resource with a welcome message
2. A simple "hello" tool that returns a greeting message
3. A greeting prompt template

## Installation

```bash
# Clone the repository
git clone https://codeberg.org/knightdave/dawids-mcp-servers.git
cd dawids-mcp-servers
```

## Usage

### Running from repository root (recommended)

```bash
# Run with stdio transport (for MCP client integration)
uv --directory /path-to-repo/dawids-mcp-servers/servers/hello_world run mcp-hello-world --transport stdio

# Run with remote transport
uv --directory /path-to-repo/dawids-mcp-servers/servers/hello_world run mcp-hello-world --transport remote --host 0.0.0.0 --port 8080
```

Replace `/path-to-repo` with the actual path to where you cloned this repository.

### Alternative: Running from server directory

```bash
cd servers/hello_world

# Run with stdio transport
uv run mcp-hello-world --transport stdio

# Run with remote transport  
uv run mcp-hello-world --transport remote --host 0.0.0.0 --port 8080
```

### Legacy methods

You can also run the server using Python module syntax:

```bash
# Run with stdio transport (default)
python -m mcp_server_hello_world

# Run with remote transport on a specific host and port
python -m mcp_server_hello_world --transport remote --host 0.0.0.0 --port 8080
```

## API Reference

### Resources

- `hello://welcome` - Returns a welcome message

### Tools

- `hello` - Takes a `name` parameter and returns a personalized greeting

### Prompts

- `greeting` - Takes a `name` parameter and returns a greeting prompt template

## Development

### Running Tests

```bash
cd /path/to/servers/hello_world
uv run pytest
```

## License

MIT