ADORSYS-GIS / ADORSYS-GIS/ai-helm
[Ticket]: Python-backed MCP batch — mem0, MCP-Mathematics, pdfmux (packaging decision)
- Langage dominant
- Go Template
- Étoiles
- 3
- Forks
- 1
- Merge moyen
- 19 h 24 min
- PR mergées (30 j)
- 80
Description
Part of #549
## Type
Feature
## Summary
Add the **Python-backed MCP batch** deferred from ADR-0071: **mem0**, **MCP-Mathematics** (both `uvx`), and **pdfmux** (npm wrapper that still needs `pip install pdfmux` + an LLM key). Requires a packaging decision since these are not bare-npx.
## Intent
Deliver PDF handling (explicitly requested — users have PDFs in projects), math, and long-term memory (mem0) once we choose how to run Python-backed servers org-wide.
## Source of truth (links)
- ADR-0071 (deferred-batch note), `docs/opencode-well-known.md`
- https://github.com/mem0ai/mem0 · https://github.com/SHSharkar/MCP-Mathematics · https://github.com/NameetP/pdfmux
## Current Behavior
Not present. ADR-0071 explicitly excluded them pending a packaging decision.
## Expected Behavior
Each Python-backed server runs via an agreed mechanism (per-user `uvx` local, or an in-cluster sidecar/gateway route) and is gated behind a dedicated subagent (e.g. `@pdf`, `@math`).
## Acceptance Criteria
- [ ] Decision recorded (ADR): `uvx` local vs in-cluster sidecar/gateway, per server.
- [ ] pdfmux's Python dep + LLM-key requirement resolved (which key, whose).
- [ ] Servers added behind subagent(s) with deny-baseline + allow.
- [ ] Renders + lints; capability verified.
## Out of Scope
- The npm-only and token-gated batches (separate tickets).
## Technical Context
`uvx` is not bare-npx; pdfmux needs `pip install pdfmux` + GEMINI/ANTHROPIC/OPENAI key. mem0 typically needs a store/server.
## Risks
- New Python packaging surface; pdfmux key provisioning; mem0 statefulness.
## Test Plan
- Validate the chosen run mechanism; exercise a PDF extraction + a math op end-to-end.
## Human accountable owner
@stephane-segning
## AI Usage Declaration
AI drafted this ticket from the ADR-0071 deferral; human owns intent + verification.
Guide de contribution
Ouvrir le guide de contribution
Piste de recherche
Start by reading ADR-0071 and docs/opencode-well-known.md, then review the deferred batch and the packaging options for mem0, MCP-Mathematics, and pdfmux. Done means the mechanism and pdfmux key requirements are recorded in an ADR, the servers are gated behind subagents, renders and lints pass, and PDF extraction plus a math operation work end to end.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- helm, kubernetes, python
- Domaine
- ai, devops, infrastructure
- Type d'issue
- Fonctionnalité
- Difficulté
- 5/5
- Temps estimé
- Plus d'une semaine
- Activité
- Calme
- Clarté
- Plutôt claire
- Accessibilité débutants
- 35/100