ADORSYS-GIS / ADORSYS-GIS/ai-helm

[Ticket]: Python-backed MCP batch — mem0, MCP-Mathematics, pdfmux (packaging decision)

Ouverte
#551 0 commentaires 0 réactions 2 personnes assignées Réclamée par @Koufan-De-King Voir sur GitHub
opencode ticket
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

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.