Metadata-Version: 2.4
Name: PyStreamMCP
Version: 1.1.2
Summary: Intelligent MCP orchestration hub - Intent understanding, capability matching, tool ranking with cohesive foundation
Home-page: https://github.com/Mullassery/PyStreamMCP
Author: Georgi Mammen Mullassery
Author-email: Georgi Mammen Mullassery <mullassery@gmail.com>
License: Proprietary
Project-URL: Repository, https://github.com/Mullassery/PyStreamMCP
Project-URL: Issues, https://github.com/Mullassery/PyStreamMCP/issues
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.0
Requires-Dist: python-frontmatter>=1.0.0
Requires-Dist: click>=8.0
Requires-Dist: rich>=13.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Provides-Extra: api
Requires-Dist: fastapi>=0.104.0; extra == "api"
Requires-Dist: uvicorn[standard]>=0.24.0; extra == "api"
Requires-Dist: pydantic-settings>=2.0; extra == "api"
Provides-Extra: mcp
Requires-Dist: mcp>=0.1.0; extra == "mcp"
Provides-Extra: langchain
Requires-Dist: langchain>=0.1.0; extra == "langchain"
Provides-Extra: llamaindex
Requires-Dist: llama-index>=0.9.0; extra == "llamaindex"
Provides-Extra: semantic-kernel
Requires-Dist: semantic-kernel>=0.4.0; extra == "semantic-kernel"
Provides-Extra: crewai
Requires-Dist: crewai>=0.1.0; extra == "crewai"
Provides-Extra: pydantic-ai
Requires-Dist: pydantic-ai>=0.1.0; extra == "pydantic-ai"
Provides-Extra: haystack
Requires-Dist: haystack-ai>=2.0.0; extra == "haystack"
Provides-Extra: temporal
Requires-Dist: temporalio>=1.0.0; extra == "temporal"
Provides-Extra: airflow
Requires-Dist: apache-airflow>=2.7.0; extra == "airflow"
Provides-Extra: all-integrations
Requires-Dist: langchain>=0.1.0; extra == "all-integrations"
Requires-Dist: llama-index>=0.9.0; extra == "all-integrations"
Requires-Dist: semantic-kernel>=0.4.0; extra == "all-integrations"
Requires-Dist: crewai>=0.1.0; extra == "all-integrations"
Requires-Dist: pydantic-ai>=0.1.0; extra == "all-integrations"
Requires-Dist: haystack-ai>=2.0.0; extra == "all-integrations"
Requires-Dist: temporalio>=1.0.0; extra == "all-integrations"
Requires-Dist: apache-airflow>=2.7.0; extra == "all-integrations"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# PyStreamMCP

Two-stage selective intelligence: metadata-first filtering + contextual reranking. 90-95% token reduction. OpenAI-compatible MCP orchestration layer for streaming.

**Latest Version:** 1.1.1

## Features

- ✅ 90-95% token reduction (selective intelligence)
- ✅ 8+ connected tools with latency tracking
- ✅ Metadata-first filtering & contextual reranking
- ✅ Production-ready CLI dashboards
- ✅ Keyboard shortcuts for quick access
- ✅ OpenTelemetry support (6 backends)

## Installation

```bash
pip install pystreammcp
```

## Quick Start

```bash
# Setup shortcuts
bash scripts/setup_shortcuts.sh

# View dashboard
dash-pystreammcp              # Static snapshot
dash-pystreammcp-live         # Live monitoring
dash-pystreammcp-export       # Export metrics

# Connect tools
pystreammcp list-tools
pystreammcp connect --provider openai
```

## Dashboard

Real-time MCP orchestration metrics:
- `dash-pystreammcp` - View tool status, selective intelligence stats
- `dash-pystreammcp-live` - Watch active executions, routing performance
- `dash-pystreammcp-export` - Export to JSON

**Metrics:** Status, Connected Tools (8+), Selective Intelligence Reduction (90-95%), Active Jobs, Routing Performance

## OpenTelemetry

Export to Prometheus, Datadog, Honeycomb, New Relic, Jaeger, or X-Ray.

```bash
export OTEL_EXPORTER_OTLP_PROTOCOL=prometheus
dash-pystreammcp-live
```

See `OTEL_SETUP_GUIDE.md`.

## Production Deployment

Kubernetes, Docker Compose, and standalone patterns included.

See `PRODUCTION_DEPLOYMENT.md`.

## Documentation

- `DASHBOARD_SHORTCUTS.md` - Keyboard shortcuts
- `OTEL_SETUP_GUIDE.md` - OpenTelemetry setup
- `PRODUCTION_DEPLOYMENT.md` - Deployment patterns

## Repository

- GitHub: https://github.com/Mullassery/PyStreamMCP
- PyPI: https://pypi.org/project/pystreammcp

## License

MIT
