AI/mcp-framework
1
0
Fork 0
Code Issues Pull requests Projects Releases 40 Packages Wiki Activity Actions
No description
72 commits 1 branch 40 tags 647 KiB
Go 100%
Find a file
thibaud-lclr 85da274772 feat: add encrypted bitwarden cache core
2026-05-02 15:00:57 +02:00
.gitea/workflows fix: durcir le scaffold runtime et la sécurité des updates 2026-04-15 12:13:41 +02:00
bootstrap feat: add bitwarden login flow with persisted BW_SESSION 2026-04-20 12:38:58 +02:00
cli feat: add --debug tracing for bitwarden calls 2026-04-20 11:36:07 +02:00
cmd/mcp-framework feat: add manifest code generation 2026-05-02 11:46:47 +02:00
config feat: add versioned config migrations 2026-04-13 17:28:47 +02:00
docs docs: plan bitwarden cache implementation 2026-05-02 14:55:52 +02:00
generate feat: generate config field helpers 2026-05-02 12:02:23 +02:00
manifest feat: parse bitwarden cache manifest option 2026-05-02 14:57:52 +02:00
scaffold fix: prompt login in red when bitwarden session is missing 2026-04-20 17:52:50 +02:00
secretstore feat: add encrypted bitwarden cache core 2026-05-02 15:00:57 +02:00
update fix(update): reject HTML artifacts during self-update 2026-04-15 14:23:15 +02:00
.gitignore update .gitignore 2026-04-13 15:47:20 +02:00
AGENTS.md docs(agents): enforce enhancement branch naming format 2026-04-14 08:31:08 +02:00
go.mod feat: add toml manifest loader for mcp projects 2026-04-13 15:52:00 +02:00
go.sum feat: add toml manifest loader for mcp projects 2026-04-13 15:52:00 +02:00
README.md docs: refresh usage documentation 2026-05-02 12:07:34 +02:00

README.md

mcp-framework

mcp-framework est une bibliothèque Go et un petit CLI pour construire des binaires MCP avec une base commune : CLI, configuration locale, secrets, manifeste mcp.toml, diagnostic et auto-update.

Installation

Dans un projet Go :

go get gitea.lclr.dev/AI/mcp-framework

Pour utiliser le CLI :

go install gitea.lclr.dev/AI/mcp-framework/cmd/mcp-framework@latest

Créer un projet MCP

mcp-framework scaffold init \
  --target ./my-mcp \
  --module example.com/my-mcp \
  --binary my-mcp \
  --profiles dev,prod

cd my-mcp
go mod tidy
go run ./cmd/my-mcp help

Le scaffold crée une arborescence prête à adapter :

cmd/<binary>/main.go
internal/app/app.go
mcp.toml
install.sh
README.md

Générer la glue depuis mcp.toml

Dans un projet qui possède un mcp.toml à la racine :

mcp-framework generate

La commande génère un package mcpgen/ avec un loader de manifeste embarqué, des helpers de métadonnées, update, secret store, et des helpers de config si [[config.fields]] est déclaré.

En CI :

mcp-framework generate --check

Utiliser les packages

Les packages peuvent être utilisés séparément :

  • bootstrap : CLI commune (setup, login, mcp, config, update, version).
  • cli : résolution de profil, setup interactif, résolution flag/env/config/secret, doctor.
  • config : stockage JSON versionné dans le répertoire de config utilisateur.
  • manifest : lecture de mcp.toml et fallback embarqué.
  • secretstore : keyring natif, environnement ou Bitwarden CLI.
  • update : téléchargement et remplacement du binaire depuis une release.
  • scaffold : génération d'un squelette de projet.
  • generate : génération de code Go depuis mcp.toml.

Documentation