Metadata-Version: 2.4
Name: topology-mcp
Version: 0.1.0
Summary: A Model Context Protocol (MCP) server for topology data
Author-email: Your Name <your.email@example.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/yourusername/topology-mcp
Project-URL: Repository, https://github.com/yourusername/topology-mcp
Project-URL: Issues, https://github.com/yourusername/topology-mcp/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.12.3
Requires-Dist: fastmcp>=2.11.0
Requires-Dist: requests>=2.25.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: flake8>=5.0.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Requires-Dist: build>=0.10.0; extra == "dev"
Dynamic: license-file

# Topology MCP Server

A Model Context Protocol (MCP) server for accessing topology data from a topology service.

## Installation

### Via pipx (recommended)

```bash
pipx install topology-mcp
```

### Via pip

```bash
pip install topology-mcp
```

## Usage

### Running the MCP Server

```bash
# Run with default settings (port 8000, SSE transport)
topology-mcp

# Run on a specific port
topology-mcp --port 9000

# Run with different transport
topology-mcp --transport stdio

# Run with custom host
topology-mcp --host 127.0.0.1 --port 8000
```

### Environment Variables

- `TOPOLOGY_URL`: Base URL for the topology service (defaults to `http://localhost:{port}`)
- `PORT`: Server port (defaults to 8000)
- `HOST`: Server host (defaults to 0.0.0.0)
- `TRANSPORT`: Transport method - sse, stdio, or streamable-http (defaults to sse)

### Available Tools

The MCP server provides the following tools:

- `get_topology_edges`: Get topology edges from the topology service
- `get_topology_graph`: Get topology graph from the topology service  
- `get_topology_nodes`: Get topology nodes from the topology service
- `get_topology_events`: Get topology events from the topology service

## Development

### Setup

```bash
# Clone the repository
git clone https://github.com/yourusername/topology-mcp.git
cd topology-mcp

# Install in development mode
pip install -e ".[dev]"
```

### Running Tests

```bash
pytest
```

### Code Formatting

```bash
black src/
```

## License

MIT License - see LICENSE file for details.
