https://claude.ai/chat/4dea4e6a-4f62-44b0-8a96-f87167a17fef https://claude.ai/public/artifacts/8f2db72a-f062-4d0c-b64c-e7f4018910d6

cloudflared tunnel --url http://localhost:3001

• Correo electrónico: test@example.com

• Contraseña: password123

Servidor MCP de tareas de PocketBase

Un servidor del Protocolo de Contexto de Modelo (MCP) que se integra con PocketBase para gestionar tareas y proyectos. Este servidor permite a los modelos de IA (como Claude) crear tareas, listar tareas con filtros de estado y explorar proyectos.

Ahora ejecutándose sobre HTTP - ¡Fácil de probar localmente y listo para el despliegue!

Características

• Transporte HTTP: Acceso sencillo basado en URL, sin necesidad de configuraciones complejas

• Encadenamiento de herramientas: Vincula automáticamente las tareas a los proyectos obteniendo primero los ID

• Gestión de proyectos: Lista todos los proyectos de la colección projects

• Gestión de tareas: Crea tareas en la colección task con relaciones obligatorias con los proyectos

• Filtrado de estado: Lista las tareas y filtra por estado 'Pending' (Pendiente) o 'Completed' (Completado)

• Basado en entorno: Gestionado de forma segura mediante un archivo .env para la autenticación de PocketBase

• Pruebas sencillas: Punto de conexión de comprobación de estado simple y soporte para el Inspector MCP

⚡ Inicio rápido

# 1. Install dependencies
npm install

# 2. Create .env file
echo "PB_AUTH_TOKEN=your_super_admin_token_here" > .env

# 3. Build the project
npm run build

# 4. Start the server
node dist/index.js

¡Tu servidor ahora se está ejecutando en http://localhost:3000!

Probarlo: Abre http://localhost:3000/health en tu navegador.

🚀 Introducción

1. Requisitos previos

• Node.js (v18+)

• PocketBase ejecutándose localmente en http://127.0.0.1:8090

• Un token de Super Admin de PocketBase.

2. Instalación

npm install

3. Configuración

Crea un archivo .env en la raíz del proyecto:

PB_AUTH_TOKEN=your_super_admin_token_here

🛠️ Desarrollo y depuración

Compilar el proyecto

Compila el código TypeScript a JavaScript:

npm run build

Iniciar el servidor HTTP

Ejecuta el servidor localmente:

node dist/index.js

El servidor se iniciará en http://localhost:3000 (o el puerto especificado en tu archivo .env).

Deberías ver una salida como:

MCP server running on http://localhost:3000
Health check: http://localhost:3000/health
MCP endpoint: http://localhost:3000/mcp

Probar el servidor

Visita el punto de conexión de comprobación de estado en tu navegador:

http://localhost:3000/health

Deberías ver:

{"status":"ok","message":"PMS MCP Server is running"}

Configuración de puerto opcional

Añade esto a tu archivo .env para cambiar el puerto:

PORT=3000
PB_AUTH_TOKEN=your_super_admin_token_here

📖 Herramientas disponibles

• list_projects: Obtiene todos los proyectos y sus ID.

• create_task: Crea una nueva tarea (requiere task_title, eta, status y project_id).

• list_tasks: Lista todas las tareas con filtrado de estado opcional.

🧪 Probar las herramientas

Puedes probar el servidor MCP usando el Inspector MCP o conectándote a través del punto de conexión HTTP en http://localhost:3000/mcp.

Usando el Inspector MCP

npx @modelcontextprotocol/inspector

Luego conéctate a: http://localhost:3000/mcp

🌐 ¿Por qué HTTP en lugar de Stdio?

Ventajas:

• Sin archivos de configuración: No es necesario editar claude_desktop_config.json u otras configuraciones complejas

• Pruebas sencillas: Acceso simple mediante URL a través del navegador o herramientas como Postman

• Listo para remoto: Se puede desplegar en un servidor y acceder desde cualquier lugar

• Múltiples clientes: Varias aplicaciones pueden conectarse simultáneamente

• Mejor depuración: Fácil de monitorizar las solicitudes y respuestas con herramientas HTTP estándar

Conexión desde clientes MCP:

Al usar clientes compatibles con MCP, conéctate a:

http://localhost:3000/mcp

📝 Dependencias

• @modelcontextprotocol/sdk: Funcionalidad principal de MCP

• pocketbase: SDK de JS para PocketBase

• express: Framework de servidor HTTP

• cors: Middleware de intercambio de recursos de origen cruzado (CORS)

• zod: Validación de esquemas

• dotenv: Gestión de variables de entorno