beeper_mcp servidor MCP
un servidor mcp para interactuar con la cadena
Componentes
Recursos
El servidor implementa un sencillo sistema de almacenamiento de notas con:
- Esquema personalizado note:// URI para acceder a notas individuales
- Cada recurso de nota tiene un nombre, una descripción y un mimetype text/plain
Avisos
El servidor proporciona un único aviso:
- resumir-notas: Crea resúmenes de todas las notas almacenadas
- Argumento opcional "style" para controlar el nivel de detalle (breve/detallado)
- Genera un aviso que combina todas las notas actuales con el estilo preferido
Herramientas
El servidor implementa una herramienta:
- add-note: Añade una nueva nota al servidor
- Toma "nombre" y "contenido" como argumentos de cadena obligatorios
- Actualiza el estado del servidor y notifica a los clientes los cambios en los recursos
Configuración
[TODO: Añada detalles de configuración específicos para su implementación]
Inicio rápido
Instalar
Escritorio Claude
En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%/Claude/claude_desktop_config.json
Desarrollo
Creación y publicación
Preparar el paquete para su distribución
- Sincronice las dependencias y actualice el archivo de bloqueo:
uv sync
- Construir la distribución del paquete:
uv build
Esto creará distribuciones fuente y rueda en el directorio dist/
.
- Publicar en PyPI:
uv publish
Nota: Tendrás que establecer las credenciales de PyPI mediante variables de entorno o banderas de comando:
- Token:
--token
oUV_PUBLISH_TOKEN
- O nombre
de
usuario/contraseña:--username/UV_PUBLISH_USERNAME
y--password/UV_PUBLISH_PASSWORD
Depuración
Dado que los servidores MCP se ejecutan a través de stdio, la depuración puede resultar complicada. Para obtener la mejor experiencia de depuración, recomendamos encarecidamente utilizar el Inspector MCP.
Puede lanzar el Inspector MCP a través de npm
con este comando:
npx @modelcontextprotocol/inspector uv --directory /Users/pan/work/openos/beeper/beeper_mcp run beeper-mcp
Tras el lanzamiento, el Inspector mostrará una URL a la que puede acceder en su navegador para comenzar la depuración.