Metadata-Version: 2.4
Name: rollinggo-mcp
Version: 0.1.0
Summary: RollingGo hotel MCP server for stdio clients.
Requires-Python: >=3.10
Requires-Dist: fastmcp==3.1.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.8.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.3.2; extra == 'dev'
Description-Content-Type: text/markdown

# rollinggo-mcp

`rollinggo-mcp` is a FastMCP-based RollingGo hotel server for MCP clients that connect over `stdio`.

This package is separate from the existing CLI projects in `rollinggo-npx` and `rollinggo-uv`. It exposes hotel tools directly as MCP tools:

- `searchHotels`
- `getHotelDetail`
- `getHotelSearchTags`

## Package And Command

- package name: `rollinggo-mcp`
- command name: `rollinggo-mcp`

## Environment

The server resolves configuration in this order:

1. `ROLLINGGO_API_KEY`
2. `AIGOHOTEL_API_KEY`

Optional overrides:

- `ROLLINGGO_BASE_URL`

Example:

```bash
$env:ROLLINGGO_API_KEY="mcp_your_key"
uv run --directory rollinggo-hotel-uv rollinggo-mcp
```

## Local Development

Install dependencies:

```bash
uv sync --directory rollinggo-hotel-uv --extra dev
```

Run the stdio server from source:

```bash
uv run --directory rollinggo-hotel-uv rollinggo-mcp
```

Run tests:

```bash
uv run --directory rollinggo-hotel-uv --extra dev pytest
```

Build:

```bash
uv build --directory rollinggo-hotel-uv
```

## MCP Client Config

Published package form:

```json
{
  "mcpServers": {
    "rollinggo-hotel": {
      "command": "uvx",
      "args": ["--from", "rollinggo-mcp", "rollinggo-mcp"],
      "env": {
        "ROLLINGGO_API_KEY": "mcp_your_key"
      }
    }
  }
}
```

Local source form:

```json
{
  "mcpServers": {
    "rollinggo-hotel": {
      "command": "uv",
      "args": ["run", "--directory", "d:/work/RollingGo-Overseas/rollinggo-hotel-uv", "rollinggo-mcp"],
      "env": {
        "ROLLINGGO_API_KEY": "mcp_your_key"
      }
    }
  }
}
```

## Notes

- transport defaults to `stdio`
- the server removes `bookingUrl` fields before returning results
- FastMCP version is pinned to `3.1.0`
