Guide de Publication MCP - StacksFinder

Ce guide explique comment publier et maintenir le serveur MCP sur toutes les plateformes pertinentes.

Table des matières

Prérequis
Publication sur npm
GitHub Release
Registres MCP
Mise à jour du package
Checklist de lancement

Prérequis

1. Compte npm

# Créer un compte sur https://www.npmjs.com/signup
# Puis se connecter
npm login

2. Token npm pour GitHub Actions

Aller sur https://www.npmjs.com/settings/YOUR_USERNAME/tokens
Cliquer Generate New Token → Classic Token
Choisir Automation (pour CI/CD)
Copier le token (commence par npm_)

3. Ajouter le secret GitHub

Aller sur https://github.com/hoklims/stack_finder/settings/secrets/actions
Cliquer New repository secret
Nom: NPM_TOKEN
Valeur: coller le token npm

1. Publication sur npm

Première publication

cd packages/mcp-server

# Vérifier que tout build
bun install
bun run build
bun run test:run

# Publier (--access public car c'est un package scopé @stacksfinder/)
npm publish --access public

Vérifier la publication

# Doit afficher les infos du package
npm info @stacksfinder/mcp-server

# Tester l'installation
npx @stacksfinder/mcp-server --help

2. GitHub Release

Publication automatique (recommandé)

Le workflow .github/workflows/mcp-publish.yml publie automatiquement quand tu push un tag:

cd packages/mcp-server

# Bump la version
npm version patch  # 1.0.0 → 1.0.1
# ou
npm version minor  # 1.0.0 → 1.1.0
# ou
npm version major  # 1.0.0 → 2.0.0

# Commit et push
git add packages/mcp-server/package.json
git commit -m "chore: release mcp-server v1.0.1"
git push

# Créer et push le tag
git tag mcp-v1.0.1
git push --tags

Le workflow va:

Builder le package
Lancer les tests
Publier sur npm
Créer une GitHub Release

Publication manuelle (si besoin)

Aller sur https://github.com/hoklims/stack_finder/releases/new
Tag: mcp-v1.0.1
Title: MCP Server v1.0.1
Description:

## What's New
- Description des changements

## Installation
\`\`\`bash
claude mcp add stacksfinder npx -y @stacksfinder/mcp-server
\`\`\`

## Full Changelog
https://github.com/hoklims/stack_finder/compare/mcp-v1.0.0...mcp-v1.0.1

3. Registres MCP

A. Smithery.ai (Principal)

URL: https://smithery.ai

Aller sur https://smithery.ai/submit

Remplir le formulaire:

Name: StacksFinder
npm package: @stacksfinder/mcp-server
Description:

Deterministic tech stack recommendations for developers. Analyze, compare, and get optimal stack suggestions for any project type. Free tools available, Pro tier for unlimited access.

Category: Developer Tools
Tags: tech-stack, recommendations, developer-tools, architecture

Soumettre et attendre l'approbation (1-3 jours)

B. PulseMCP

URL: https://pulsemcp.com

Aller sur https://pulsemcp.com/submit
Remplir:
- Server Name: stacksfinder
- npm: @stacksfinder/mcp-server
- GitHub: https://github.com/hoklims/stack_finder
- Description: Tech stack recommendations with 6-dimension scoring
Soumettre

C. awesome-mcp-servers (GitHub)

URL: https://github.com/punkpeye/awesome-mcp-servers

Fork le repo
Éditer README.md, ajouter dans la section appropriée:

- [StacksFinder](https://github.com/hoklims/stack_finder/tree/master/packages/mcp-server) - Deterministic tech stack recommendations with 6-dimension scoring. Analyze, compare, and get optimal stack suggestions.

Créer une Pull Request avec:

Title: Add StacksFinder MCP server
Description:

Adding StacksFinder - a deterministic tech stack recommendation engine.

- 10 tools (4 free, 6 Pro)
- 6-dimension scoring (perf, dx, ecosystem, maintainability, cost, compliance)
- 30+ technologies across 8 categories
- Free demo: 1 recommendation/day without account

npm: @stacksfinder/mcp-server

D. MCP.so (Communauté)

URL: https://mcp.so

Créer un compte
Aller sur "Submit Server"
Remplir avec les mêmes infos que Smithery

E. glama.ai MCP Directory

URL: https://glama.ai/mcp/servers

Le répertoire scrape automatiquement depuis npm + GitHub
S'assurer que package.json contient les bons keywords:
```
"keywords": ["mcp", "model-context-protocol", ...]
```
Généralement indexé automatiquement après publication npm

F. Claude MCP Registry (Officiel Anthropic)

URL: https://github.com/anthropics/claude-mcp-servers

Fork le repo
Ajouter un fichier servers/stacksfinder.json:

{
  "name": "stacksfinder",
  "displayName": "StacksFinder",
  "description": "Deterministic tech stack recommendations with 6-dimension scoring",
  "npm": "@stacksfinder/mcp-server",
  "repository": "https://github.com/hoklims/stack_finder",
  "homepage": "https://stacksfinder.com",
  "author": "StacksFinder",
  "license": "MIT",
  "categories": ["developer-tools", "productivity"],
  "tools": [
    "list_technologies",
    "analyze_tech",
    "compare_techs",
    "recommend_stack",
    "get_blueprint",
    "create_blueprint"
  ]
}

Créer une PR

4. Mise à jour du package

Workflow standard

# 1. Faire tes modifications dans packages/mcp-server/

# 2. Mettre à jour DATA_VERSION si les données changent
# Dans src/data/index.ts

# 3. Rebuild
cd packages/mcp-server
bun run build
bun run test:run

# 4. Bump version + tag + push
npm version patch
git add .
git commit -m "chore: release mcp-server v1.0.2"
git push
git tag mcp-v1.0.2
git push --tags

# → Le workflow GitHub publie automatiquement

Types de versions

Type	Quand	Exemple
`patch`	Bugfix, mise à jour données	1.0.0 → 1.0.1
`minor`	Nouveau tool, nouvelle feature	1.0.0 → 1.1.0
`major`	Breaking change (API change)	1.0.0 → 2.0.0

Mise à jour des registres

La plupart des registres (Smithery, PulseMCP, glama.ai) se mettent à jour automatiquement depuis npm. Pas besoin de re-soumettre.

Pour awesome-mcp-servers, tu peux mettre à jour ta PR si tu ajoutes des features majeures.

Checklist de lancement

Avant la première publication

Créer compte npm
npm login
Générer token npm (Automation)
Ajouter secret NPM_TOKEN sur GitHub
Vérifier que package.json est complet (author, repository, keywords, etc.)
README.md à jour avec exemples
Tests passent: bun run test:run
Build OK: bun run build

Publication initiale

npm publish --access public
Vérifier sur https://www.npmjs.com/package/@stacksfinder/mcp-server
Tester: npx @stacksfinder/mcp-server
Créer tag: git tag mcp-v1.0.0 && git push --tags

Soumission aux registres

Smithery.ai - https://smithery.ai/submit
PulseMCP - https://pulsemcp.com/submit
awesome-mcp-servers - PR sur GitHub
MCP.so - https://mcp.so
Claude MCP Registry - PR sur GitHub (optionnel, review stricte)

Communication

Tweet/post sur X avec démo
Post sur r/LocalLLaMA, r/ClaudeAI
Article de blog sur stacksfinder.com
Ajouter badge MCP sur la homepage

Ressources

npm: https://www.npmjs.com/package/@stacksfinder/mcp-server
GitHub: https://github.com/hoklims/stack_finder/tree/master/packages/mcp-server
MCP Spec: https://modelcontextprotocol.io
Anthropic MCP Docs: https://docs.anthropic.com/en/docs/build-with-claude/mcp