Metadata-Version: 2.4
Name: mcp-observatory-server
Version: 1.0.0
Summary: MCP query router for observability of distributed MCP server fleets.
Author-email: vellankikoti <vellankikoti@gmail.com>
License: Apache-2.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.11
Requires-Dist: fastmcp>=3.0
Requires-Dist: httpx>=0.27
Requires-Dist: instructor>=1.3
Requires-Dist: litellm>=1.40
Requires-Dist: opentelemetry-api>=1.25
Requires-Dist: pydantic>=2.7
Requires-Dist: rich>=13.7
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
Requires-Dist: pytest>=8.2; extra == 'dev'
Requires-Dist: pyyaml>=6.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Requires-Dist: types-pyyaml; extra == 'dev'
Description-Content-Type: text/markdown

# mcp-observatory-server

MCP query-router + CLI for observing distributed MCP server fleets. 9 typed query tools including the hero `detect_tool_abandonment` signal.

## Install

```bash
uvx mcp-observatory-server --help
# or
pip install mcp-observatory-server
```

## Claude Desktop

```json
{
  "mcpServers": {
    "observatory": {
      "command": "uvx",
      "args": ["mcp-observatory-server", "serve-mcp"]
    }
  }
}
```

## Tools

`list_mcp_servers`, `get_tool_call_rate`, `get_tool_error_rate`, `get_tool_latency_p99`, `compare_servers`, `detect_tool_abandonment`, `get_fleet_health`, `explain_fleet_health`, `verify_services`.

See the [main repo](https://github.com/vellankikoti/mcp-observatory) for design, workshop, Helm chart, and SDK docs.

Companion: [**mcp-observatory-sdk**](https://pypi.org/project/mcp-observatory-sdk/) — instrument your MCP servers to emit the metrics this tool consumes.
