Metadata-Version: 2.5
Name: sqxtreme-mcp
Version: 0.4.3
Summary: Windows-first DX, Spanish localization, and content library layer over sq-mcp for StrategyQuant X
Project-URL: Homepage, https://github.com/herjarsa/sqxtreme-mcp
Author: SQXtreme contributors
License: MIT
Keywords: claude-code,mcp,opencode,spanish,strategyquant,windows
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]<2,>=1.13.0
Requires-Dist: pydantic>=2.7.0
Provides-Extra: dev
Requires-Dist: mypy>=1.10.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.2.0; extra == 'dev'
Requires-Dist: ruff>=0.5.0; extra == 'dev'
Provides-Extra: full
Requires-Dist: sq-mcp<0.5,>=0.4.9; extra == 'full'
Description-Content-Type: text/markdown

# SQXtreme — StrategyQuant X MCP control layer

Wrapper/extension over [sq-mcp](https://github.com/DAVIDAROCA27/sqx-mcp) that adds Windows-first DX, Spanish localization, and multi-client configs for AI agents (opencode, Claude Code, Cursor, VS Code).

**Repo**: https://github.com/herjarsa/sqxtreme-mcp

## What ships in v0.4.3

`sq-mcp` (DAVIDAROCA27) is the foundation: 482 runtime tools, MIT, 1571 tests. SQXtreme v0.4.3 adds (126 tests, 1 skipped; CI verde ubuntu+windows × py3.10–3.12; OIDC publish):

1. **Windows installer** — `iwr install.ps1 | iex` (4 modos: CheckOnly/PyPI/FromSource/FromGit)
2. **Spanish localization** — 5 workflow prompts + 4 sub-agentes (`prompts/es/`)
3. **Multi-client configs** — Claude Code, opencode, Cursor, VS Code (`examples/`)
4. **HTTP transport** — `SQXTREME_TRANSPORT=http` → `streamable-http` en `:8765` (vs nativo `:8082`)
5. **12 features 3 fases** — AlgoWizard auto-import, Builder desde frase, Live Watch, Streaming, Data auto-fix, Auto-curator, Ship MT5, Snapshot rollback, Ashare 119, Scheduled Runner, sqx-tools wrapper, Health Dashboard
6. **Visual QA + Orchestrator (v0.4.2)** — `qa_dashboard(metrics)`, `orchestrate(workspaces)`
7. **Audit fixes (v0.4.3)** — 26 fixes aplicados: TOCTOU race fix, path traversal hardening, injection guard regex, version sync via `importlib.metadata`, mypy `Literal` type narrowing, 4 new tests files, 29 nuevos tests. Ver `CHANGELOG.md` para detalle completo.
8. **CI matrix** — Ubuntu + Windows × Python 3.10/3.11/3.12 — ruff + mypy + pytest
9. **PyPI OIDC** — Trusted Publishing sin token manual (`publish.yml`)

## Roadmap (post v0.4.3)

Migración a `mcp>=2.0` cuando sea estable (actualmente pin `<2` por `FastMCP→MCPServer` rename).

## Install

```powershell
# One-liner (after PyPI publish)
iwr https://raw.githubusercontent.com/herjarsa/sqxtreme-mcp/main/install.ps1 -UseBasicParsing | iex

# Or from source
git clone https://github.com/herjarsa/sqxtreme-mcp.git
cd sqxtreme-mcp
.\scripts\install.ps1 -FromSource
```

## What this gets you (honest scope)

Running an AI agent with SQXtreme + `[full]` extra: 9 Spanish MCP prompts + 482 sq-mcp runtime tools delegated + cross-client install + 26 audit fixes de seguridad.

NOT included in v0.4.3: a live AI agent actually connected (manual client setup per `docs/CLIENTS.md`), E2E test with real SQ X engine.

## Security

v0.4.3 incluye auditoria completa de seguridad:
- 5 fixes Critical (path traversal, CWD fallback, TOCTOU race, file corruption, Unix-only test)
- 10 fixes Important (injection guard regex, version drift, KeyError, stdout pollution, etc.)
- Full report: `AUDIT_REPORT.md` (902 lines)

## License

MIT.
