AI/mcp-framework
1
0
Fork 0
Code Issues Pull requests Projects Releases 40 Packages Wiki Activity Actions
No description
82 commits 1 branch 40 tags 647 KiB
Go 100%
Find a file
thibaud-lclr 4a7248cfa9 feat(bootstrap): add DisabledCommands option to hide unused commands 
Commands listed in DisabledCommands are excluded from global help output
and return ErrUnknownCommand when invoked or help is requested for them.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-12 10:30:11 +02:00
.forgejo/workflows fix: rename .forgejo 2026-05-11 11:53:59 +02:00
bootstrap feat(bootstrap): add DisabledCommands option to hide unused commands 2026-05-12 10:30:11 +02:00
cli chore: update module path to forge 2026-05-05 12:23:14 +02:00
cmd/mcp-framework chore: update module path to forge 2026-05-05 12:23:14 +02:00
config feat: add versioned config migrations 2026-04-13 17:28:47 +02:00
docs chore: update module path to forge 2026-05-05 12:23:14 +02:00
generate chore: update module path to forge 2026-05-05 12:23:14 +02:00
manifest chore: update module path to forge 2026-05-05 12:23:14 +02:00
scaffold chore: update module path to forge 2026-05-05 12:23:14 +02:00
secretstore chore: update module path to forge 2026-05-05 12:23:14 +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 chore: update module path to forge 2026-05-05 12:23:14 +02:00
go.sum feat: add toml manifest loader for mcp projects 2026-04-13 15:52:00 +02:00
README.md chore: update module path to forge 2026-05-05 12:23:14 +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 forge.lclr.dev/AI/mcp-framework

Pour utiliser le CLI :

go install forge.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