@enokdev/springdocs-mcp 1.1.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +67 -67
- package/EXAMPLES.md +0 -186
- package/EXAMPLES_FR.md +186 -0
- package/INSTALL.md +0 -123
- package/INSTALL_FR.md +123 -0
- package/README.md +180 -106
- package/README_FR.md +219 -0
- package/package.json +1 -1
- package/DEPLOYMENT.md +0 -205
- package/PUBLICATION_ENOKDEV.md +0 -170
- package/PUBLISHING.md +0 -196
- package/README_ENOKDEV.md +0 -108
package/PUBLISHING.md
DELETED
|
@@ -1,196 +0,0 @@
|
|
|
1
|
-
# 📦 Guide de publication - Spring Documentation MCP Server
|
|
2
|
-
|
|
3
|
-
Ce guide explique comment publier le serveur MCP pour que tout le monde puisse l'utiliser.
|
|
4
|
-
|
|
5
|
-
## 🚀 Étapes de publication
|
|
6
|
-
|
|
7
|
-
### 1. Préparation du repository GitHub
|
|
8
|
-
|
|
9
|
-
```bash
|
|
10
|
-
# Initialiser Git (si pas déjà fait)
|
|
11
|
-
git init
|
|
12
|
-
git add .
|
|
13
|
-
git commit -m "Initial commit: Spring Documentation MCP Server v1.1.0"
|
|
14
|
-
|
|
15
|
-
# Créer un repository sur GitHub
|
|
16
|
-
# Puis connecter le repository local
|
|
17
|
-
git remote add origin https://github.com/tky0065/springdocs-mcp.git
|
|
18
|
-
git branch -M main
|
|
19
|
-
git push -u origin main
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
### 2. Publication sur npm
|
|
23
|
-
|
|
24
|
-
#### A. Créer un compte npm
|
|
25
|
-
```bash
|
|
26
|
-
npm adduser
|
|
27
|
-
# ou
|
|
28
|
-
npm login
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
#### B. Vérifier la configuration
|
|
32
|
-
```bash
|
|
33
|
-
npm whoami
|
|
34
|
-
npm config list
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
#### C. Test avant publication
|
|
38
|
-
```bash
|
|
39
|
-
npm run build
|
|
40
|
-
npm pack --dry-run
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
#### D. Publication
|
|
44
|
-
```bash
|
|
45
|
-
# Publication initiale
|
|
46
|
-
npm publish --access public
|
|
47
|
-
|
|
48
|
-
# Ou pour une mise à jour
|
|
49
|
-
npm version patch # ou minor/major
|
|
50
|
-
npm publish
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
### 3. Création d'un registry MCP public
|
|
54
|
-
|
|
55
|
-
#### A. Créer un fichier de registry
|
|
56
|
-
```json
|
|
57
|
-
{
|
|
58
|
-
"name": "@enokdev/springdocs-mcp",
|
|
59
|
-
"description": "Spring Documentation MCP Server for Claude Desktop",
|
|
60
|
-
"version": "1.1.0",
|
|
61
|
-
"homepage": "https://github.com/tky0065/springdocs-mcp",
|
|
62
|
-
"repository": "https://github.com/tky0065/springdocs-mcp.git",
|
|
63
|
-
"author": "EnokDev",
|
|
64
|
-
"license": "MIT",
|
|
65
|
-
"keywords": ["mcp", "spring", "documentation", "claude"],
|
|
66
|
-
"installation": {
|
|
67
|
-
"npm": "@enokdev/springdocs-mcp",
|
|
68
|
-
"github": "tky0065/springdocs-mcp"
|
|
69
|
-
},
|
|
70
|
-
"usage": {
|
|
71
|
-
"command": "springdocs-mcp",
|
|
72
|
-
"config": {
|
|
73
|
-
"mcpServers": {
|
|
74
|
-
"spring-docs": {
|
|
75
|
-
"command": "springdocs-mcp"
|
|
76
|
-
}
|
|
77
|
-
}
|
|
78
|
-
}
|
|
79
|
-
}
|
|
80
|
-
}
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
## 🌐 Distribution publique
|
|
84
|
-
|
|
85
|
-
### 1. Via npm (recommandé)
|
|
86
|
-
Les utilisateurs peuvent installer avec :
|
|
87
|
-
```bash
|
|
88
|
-
npm install -g @enokdev/springdocs-mcp
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
### 2. Via GitHub Releases
|
|
92
|
-
```bash
|
|
93
|
-
# Créer un tag de version
|
|
94
|
-
git tag v1.1.0
|
|
95
|
-
git push origin v1.1.0
|
|
96
|
-
|
|
97
|
-
# Créer une release sur GitHub avec les binaires
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
### 3. Via Docker (optionnel)
|
|
101
|
-
```dockerfile
|
|
102
|
-
FROM node:18-alpine
|
|
103
|
-
WORKDIR /app
|
|
104
|
-
COPY package*.json ./
|
|
105
|
-
RUN npm ci --only=production
|
|
106
|
-
COPY build/ ./build/
|
|
107
|
-
EXPOSE 3000
|
|
108
|
-
CMD ["node", "build/index.js"]
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
## 📋 Liste de vérification avant publication
|
|
112
|
-
|
|
113
|
-
- [ ] ✅ **Code testé** - Tous les outils fonctionnent
|
|
114
|
-
- [ ] ✅ **Documentation complète** - README, INSTALL, EXAMPLES
|
|
115
|
-
- [ ] ✅ **Version mise à jour** - package.json et code source
|
|
116
|
-
- [ ] ✅ **License ajoutée** - MIT License
|
|
117
|
-
- [ ] ✅ **Repository GitHub** - Code source accessible
|
|
118
|
-
- [ ] ✅ **npm configuré** - Accès de publication
|
|
119
|
-
- [ ] ✅ **Keywords optimisés** - Pour la découverte
|
|
120
|
-
- [ ] ✅ **Tests passés** - Script de test fonctionne
|
|
121
|
-
|
|
122
|
-
## 🔧 Configuration pour les utilisateurs
|
|
123
|
-
|
|
124
|
-
### Configuration Claude Desktop simplifiée
|
|
125
|
-
```json
|
|
126
|
-
{
|
|
127
|
-
"mcpServers": {
|
|
128
|
-
"spring-docs": {
|
|
129
|
-
"command": "springdocs-mcp"
|
|
130
|
-
}
|
|
131
|
-
}
|
|
132
|
-
}
|
|
133
|
-
```
|
|
134
|
-
|
|
135
|
-
### Documentation utilisateur
|
|
136
|
-
Créer des guides pour :
|
|
137
|
-
- Installation rapide
|
|
138
|
-
- Configuration Claude Desktop
|
|
139
|
-
- Exemples d'utilisation
|
|
140
|
-
- Dépannage
|
|
141
|
-
|
|
142
|
-
## 📈 Promotion et visibilité
|
|
143
|
-
|
|
144
|
-
### 1. Soumission aux annuaires MCP
|
|
145
|
-
- Registre officiel MCP (si disponible)
|
|
146
|
-
- Awesome MCP lists sur GitHub
|
|
147
|
-
- Documentation Anthropic
|
|
148
|
-
|
|
149
|
-
### 2. Communication
|
|
150
|
-
- Article de blog
|
|
151
|
-
- Post LinkedIn/Twitter
|
|
152
|
-
- Documentation Spring Boot community
|
|
153
|
-
- Slack/Discord Spring Boot
|
|
154
|
-
|
|
155
|
-
### 3. SEO et découvrabilité
|
|
156
|
-
- Keywords optimisés dans package.json
|
|
157
|
-
- README avec badges
|
|
158
|
-
- Documentation claire
|
|
159
|
-
- Exemples concrets
|
|
160
|
-
|
|
161
|
-
## 🔄 Maintenance continue
|
|
162
|
-
|
|
163
|
-
### 1. Versioning sémantique
|
|
164
|
-
- **PATCH** : Corrections de bugs
|
|
165
|
-
- **MINOR** : Nouvelles fonctionnalités
|
|
166
|
-
- **MAJOR** : Changements incompatibles
|
|
167
|
-
|
|
168
|
-
### 2. Monitoring
|
|
169
|
-
- GitHub issues
|
|
170
|
-
- npm downloads
|
|
171
|
-
- Feedback utilisateurs
|
|
172
|
-
|
|
173
|
-
### 3. Mises à jour
|
|
174
|
-
- Dépendances sécurisées
|
|
175
|
-
- Nouvelles fonctionnalités Spring
|
|
176
|
-
- Améliorations MCP
|
|
177
|
-
|
|
178
|
-
---
|
|
179
|
-
|
|
180
|
-
## 🎯 Commandes de publication rapide
|
|
181
|
-
|
|
182
|
-
```bash
|
|
183
|
-
# Préparation
|
|
184
|
-
npm run build
|
|
185
|
-
npm test
|
|
186
|
-
|
|
187
|
-
# Publication
|
|
188
|
-
npm version minor
|
|
189
|
-
git add .
|
|
190
|
-
git commit -m "Release v$(node -p "require('./package.json').version")"
|
|
191
|
-
git tag "v$(node -p "require('./package.json').version")"
|
|
192
|
-
git push origin main --tags
|
|
193
|
-
npm publish --access public
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
🌟 **Votre serveur MCP sera alors accessible à tous les utilisateurs de Claude Desktop !**
|
package/README_ENOKDEV.md
DELETED
|
@@ -1,108 +0,0 @@
|
|
|
1
|
-
# 🎯 Publication rapide - Instructions pour EnokDev
|
|
2
|
-
|
|
3
|
-
## ✅ Tout est prêt !
|
|
4
|
-
|
|
5
|
-
Votre serveur MCP Spring Documentation est configuré et prêt pour la publication publique avec vos informations :
|
|
6
|
-
|
|
7
|
-
- **npm**: `@enokdev/springdocs-mcp`
|
|
8
|
-
- **GitHub**: `tky0065/springdocs-mcp`
|
|
9
|
-
- **Commande**: `springdocs-mcp`
|
|
10
|
-
|
|
11
|
-
## 🚀 Publication en 3 étapes
|
|
12
|
-
|
|
13
|
-
### 1. Créer le repository GitHub
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
# Aller sur GitHub et créer un nouveau repository public:
|
|
17
|
-
# Nom: springdocs-mcp
|
|
18
|
-
# Description: Spring Documentation MCP Server for Claude Desktop - Access the complete Spring ecosystem in Claude
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
### 2. Connecter et publier
|
|
22
|
-
|
|
23
|
-
```bash
|
|
24
|
-
# Dans votre terminal
|
|
25
|
-
cd /Users/yacoubakone/Documents/dev/springdocsmcp
|
|
26
|
-
|
|
27
|
-
# Script automatique de publication
|
|
28
|
-
./publish.sh
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
**Ou manuellement :**
|
|
32
|
-
|
|
33
|
-
```bash
|
|
34
|
-
# Connecter le repository
|
|
35
|
-
git remote add origin https://github.com/tky0065/springdocs-mcp.git
|
|
36
|
-
git add .
|
|
37
|
-
git commit -m "Initial release v1.1.0"
|
|
38
|
-
git push -u origin main
|
|
39
|
-
|
|
40
|
-
# Se connecter à npm
|
|
41
|
-
npm login # avec votre compte enokdev
|
|
42
|
-
|
|
43
|
-
# Publier
|
|
44
|
-
npm publish --access public
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
### 3. Créer une release
|
|
48
|
-
|
|
49
|
-
```bash
|
|
50
|
-
git tag v1.1.0
|
|
51
|
-
git push origin v1.1.0
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
## 📦 Après publication
|
|
55
|
-
|
|
56
|
-
### Les utilisateurs pourront installer avec :
|
|
57
|
-
|
|
58
|
-
```bash
|
|
59
|
-
npm install -g @enokdev/springdocs-mcp
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
### Configuration Claude Desktop :
|
|
63
|
-
|
|
64
|
-
```json
|
|
65
|
-
{
|
|
66
|
-
"mcpServers": {
|
|
67
|
-
"spring-docs": {
|
|
68
|
-
"command": "springdocs-mcp"
|
|
69
|
-
}
|
|
70
|
-
}
|
|
71
|
-
}
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
## 🌟 Liens de votre package
|
|
75
|
-
|
|
76
|
-
- **npm package**: https://www.npmjs.com/package/@enokdev/springdocs-mcp
|
|
77
|
-
- **GitHub repo**: https://github.com/tky0065/springdocs-mcp
|
|
78
|
-
- **Documentation**: https://tky0065.github.io/springdocs-mcp (après publication)
|
|
79
|
-
- **Stats**: https://npm-stat.com/charts.html?package=@enokdev/springdocs-mcp
|
|
80
|
-
|
|
81
|
-
## 📱 Message de lancement suggéré
|
|
82
|
-
|
|
83
|
-
```
|
|
84
|
-
🚀 Nouveau: @enokdev/springdocs-mcp
|
|
85
|
-
|
|
86
|
-
Un serveur MCP qui donne accès à TOUTE la documentation Spring directement dans Claude Desktop !
|
|
87
|
-
|
|
88
|
-
✨ 7 outils MCP
|
|
89
|
-
📚 Spring Boot + Security + Data + Cloud + tous les projets
|
|
90
|
-
🔍 Recherche intelligente
|
|
91
|
-
⚡ Installation: npm install -g @enokdev/springdocs-mcp
|
|
92
|
-
|
|
93
|
-
Perfect pour les développeurs Spring utilisant Claude !
|
|
94
|
-
|
|
95
|
-
#SpringBoot #Claude #MCP #OpenSource
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
## 🔧 Maintenance
|
|
99
|
-
|
|
100
|
-
Pour publier des mises à jour :
|
|
101
|
-
|
|
102
|
-
```bash
|
|
103
|
-
./publish.sh # Script automatique
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
---
|
|
107
|
-
|
|
108
|
-
**🎉 Votre outil va aider toute la communauté des développeurs Spring !**
|