Metadata-Version: 2.4
Name: bus-query-mcp
Version: 0.1.3
Summary: A Model Context Protocol (MCP) service for data retrieval and query operations.
Project-URL: Homepage, https://github.com/yourusername/bus-query-mcp
Project-URL: Documentation, https://github.com/yourusername/bus-query-mcp#readme
Project-URL: Repository, https://github.com/yourusername/bus-query-mcp
Project-URL: Issues, https://github.com/yourusername/bus-query-mcp/issues
Author-email: Your Name <your.email@example.com>
License: MIT
Keywords: bus,mcp,query,transportation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: mcp>=0.9.0
Description-Content-Type: text/markdown

# MCP Service

A Model Context Protocol (MCP) service for data retrieval and query operations.

## Features

- Query data from external sources
- Retrieve real-time information
- Support multiple data sources
- Flexible query parameters

## Installation

```bash
pip install bus-query-mcp
```

Or using uv:

```bash
uv pip install bus-query-mcp
```

## Usage

### Start MCP Server

```bash
bus-query-mcp
```

### Available Tools

#### 1. search_data

Search for available data records.

**Parameters:**
- `key` (str): Search keyword

**Returns:**
- List of matching records with details

#### 2. get_location_info

Query real-time location information.

**Parameters:**
- `detail_url` (str): Detail URL for precise query
- `direction` (str, optional): Query direction

**Returns:**
- Location information with coordinates

#### 3. get_record_info

Query basic record information.

**Parameters:**
- `detail_url` (str): Detail URL for precise query

**Returns:**
- Basic information about the record

## Dependencies

- Python >= 3.10
- aiohttp >= 3.9.0
- mcp >= 0.9.0
- beautifulsoup4 >= 4.12.0

## Development

### Install Dependencies

```bash
pip install -e .
```

### Run Tests

```bash
python -m bus_query_mcp.main
```

## License

MIT License

## Notes

- This service is for educational purposes
- Please respect rate limits
- Data accuracy may vary