beeper_mcp Serveur MCP

un serveur mcp pour interagir avec la chaîne

Composants

Ressources

Le serveur implémente un système simple de stockage de notes avec :

• Un schéma URI note:// personnalisé pour l'accès aux notes individuelles
• Chaque ressource note a un nom, une description et un type d'image text/plain

Invites

Le serveur fournit une seule invite :

• summarize-notes : Crée des résumés de toutes les notes stockées
  • L'argument facultatif "style" permet de contrôler le niveau de détail (bref/détaillé)
  • Génère une invite combinant toutes les notes actuelles avec la préférence de style

Outils

Le serveur met en œuvre un outil :

• add-note : ajoute une nouvelle note au serveur
  • Prend "name" et "content" comme arguments de chaîne requis
  • Met à jour l'état du serveur et informe les clients des changements de ressources

Configuration

[TODO : Ajoutez des détails de configuration spécifiques à votre implémentation]

Démarrage rapide

Installer

Bureau Claude

Sur MacOS : ~/Bibliothèque/Application\ Support/Claude/claude_desktop_config.jsonSur Windows : %APPDATA%/Claude/claude_desktop_config.json

Développement

Construction et publication

Préparer le paquet pour la distribution :

1. Synchroniser les dépendances et mettre à jour le fichier de verrouillage :

uv sync

2. Créer des distributions de paquets :

uv build

Cela créera les distributions source et wheel dans le répertoire dist/.

3. Publier sur PyPI :

uv publish

Note : Vous devrez définir les informations d'identification PyPI via des variables d'environnement ou des drapeaux de commande :

• Token : --token ou UV_PUBLISH_TOKEN
• Ou nom d'utilisateur/mot de passe : --username/UV_PUBLISH_USERNAME et --password/UV_PUBLISH_PASSWORD

Débogage

Les serveurs MCP fonctionnant sur stdio, le débogage peut s'avérer difficile. Pour une expérience de débogage optimale, nous recommandons vivement d'utiliser l'inspecteur MCP.

Vous pouvez lancer l'inspecteur MCP via npm avec cette commande :

npx @modelcontextprotocol/inspector uv --directory /Users/pan/work/openos/beeper/beeper_mcp run beeper-mcp

Au lancement, l'inspecteur affichera une URL à laquelle vous pourrez accéder dans votre navigateur pour commencer le débogage.