satelia-mcp-starter
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@satelia-mcp-starter Compter les mots et caractères de 'Bonjour le monde'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
satelia-mcp-starter
Une base de depart propre et minimale pour creer votre propre serveur MCP en TypeScript.
C'est quoi ?
Un serveur MCP (Model Context Protocol) est un petit programme qui ajoute des "outils" a Claude. Une fois branche a Claude Desktop, vous pouvez demander a Claude d'utiliser ces outils pendant une conversation.
Ce depot contient deja :
un serveur fonctionnel, pret a lancer ;
UN outil d'exemple,
compter-mots, qui compte les mots et les caracteres d'un texte ;un emplacement clairement balise pour ajouter vos propres outils.
L'idee : vous clonez ce depot, vous lancez quelques commandes, et vous construisez vos outils par-dessus sans avoir a tout recreer.
Related MCP server: MCP Calculator Server
Prerequis
Node.js version 18 ou superieure. Pour verifier, ouvrez un terminal et tapez :
node --versionSi Node n'est pas installe, telechargez-le sur le site officiel : https://nodejs.org (choisissez la version "LTS").
Installation, etape par etape
Cloner le depot, puis entrer dans le dossier :
git clone <adresse-du-depot> cd satelia-mcp-starterInstaller les dependances (les librairies dont le projet a besoin) :
npm installConstruire le projet (transformer le code TypeScript en JavaScript executable) :
npm run buildSi tout se passe bien, un dossier
buildapparait. Il contient le fichierbuild/index.jsque Claude utilisera.
Connecter le serveur a Claude Desktop
Claude Desktop lit un fichier de configuration ou vous declarez vos serveurs MCP.
Recuperez le chemin ABSOLU vers
build/index.js. Depuis le dossier du projet :pwdCela affiche le chemin du dossier, par exemple
/Users/vous/satelia-mcp-starter. Le chemin complet vers le fichier sera donc/Users/vous/satelia-mcp-starter/build/index.js.Ouvrez le fichier de configuration de Claude Desktop :
macOS :
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows :
%APPDATA%\Claude\claude_desktop_config.json
Ajoutez votre serveur dans la section
mcpServers(remplacez le chemin par le votre) :{ "mcpServers": { "satelia-mcp-starter": { "command": "node", "args": ["/Users/vous/satelia-mcp-starter/build/index.js"] } } }Fermez puis rouvrez Claude Desktop. Votre outil
compter-motsdoit maintenant etre disponible. Essayez de demander a Claude : "Combien de mots dans cette phrase ?"
Note : a chaque fois que vous modifiez le code, relancez npm run build, puis redemarrez Claude Desktop pour qu'il prenne en compte la nouvelle version.
Ajouter votre propre outil
Tout se passe dans le fichier src/index.ts. Cherchez le bloc bien visible :
// ====== AJOUTEZ VOTRE OUTIL ICI ======En 4 etapes simples :
Copiez l'exemple commente situe juste sous ce bloc (l'outil
saluer).Retirez les
//en debut de ligne pour activer le code.Adaptez : le nom de l'outil, sa description, ses champs d'entree (
inputSchema) et ce que renvoie le handler.Lancez
npm run buildpour verifier que tout compile, puis redemarrez Claude Desktop.
Conseil : decrivez chaque champ avec .describe("...") en francais. Plus la description est claire, mieux Claude saura quand et comment utiliser votre outil.
Tester sans rebuild
Pendant que vous developpez, vous pouvez lancer le serveur directement depuis le code source, sans passer par npm run build :
npm run devLe serveur demarre et affiche un message de confirmation. C'est pratique pour verifier rapidement qu'il n'y a pas d'erreur. Pour l'arreter, appuyez sur Ctrl + C.
Tester visuellement avec l'inspecteur
Pour voir vos outils et les essayer dans une petite interface, sans passer par Claude Desktop :
npm run build
npx @modelcontextprotocol/inspector node build/index.jsUne page s'ouvre dans le navigateur : vous y voyez la liste de vos outils et pouvez les appeler a la main pour verifier leur resultat.
Commandes utiles
npm run build: compile le projet dans le dossierbuild.npm run start: lance la version compilee (build/index.js).npm run dev: lance directement le code source, ideal pour tester pendant le developpement.
Licence
MIT. Voir le fichier LICENSE.
Available Tools
1 toolcompter-motsCompter les motsA
Compte le nombre de mots et de caracteres d'un texte fourni. Utile pour mesurer la longueur d'un message, d'un resume ou d'un paragraphe.
Inputs: texte (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion between tools. The single tool has a clear, unique purpose.
The single tool follows a verb_noun pattern ('compter-mots'), which is consistent and descriptive. No other tools to create inconsistency.
A server with only one tool feels too minimal for a general 'starter' server. While the tool itself is useful, the server would benefit from additional related tools to justify its existence.
The tool fully covers its stated purpose of counting words and characters. However, it lacks other text analysis features (e.g., sentence count, reading time) that might be expected in a text utility server.
Maintenance
Related MCP Connectors
A simple Typescript MCP server built using the official MCP Typescript SDK and smithery/cli. This…
MCP Server for Slima - AI Writing IDE for Novel Authors with AI Beta Reader.
Related MCP Servers
- AlicenseBqualityDmaintenanceA simple TypeScript MCP server that provides two tools: one for greeting users with a customizable name and another for adding two numbers together.2MIT
- AlicenseNot gradedqualityDmaintenanceA lightweight TypeScript-based MCP server that demonstrates how to build custom MCP tools by implementing a simple addition calculator. Serves as a starting point for building MCP-compatible tools.MIT
- AlicenseAqualityCmaintenanceA minimal TypeScript MCP server that provides echo and text_stats tools for text validation and word/character counting over stdio.2MIT
- AlicenseNot gradedqualityDmaintenanceA starter MCP server built with the official TypeScript SDK, providing example tools for echoing messages and getting current time.MIT