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

• Email: test@example.com

• Пароль: password123

MCP-сервер задач PocketBase

Сервер протокола контекста моделей (MCP), который интегрируется с PocketBase для управления задачами и проектами. Этот сервер позволяет моделям ИИ (таким как Claude) создавать задачи, просматривать список задач с фильтрацией по статусу и просматривать проекты.

Теперь работает через HTTP — легко тестировать локально и готово к развертыванию!

Возможности

• HTTP-транспорт: простой доступ по URL, не требуется сложная настройка

• Цепочки инструментов: автоматическая привязка задач к проектам путем предварительного получения ID

• Управление проектами: получение списка всех проектов из коллекции projects

• Управление задачами: создание задач в коллекции task с обязательной привязкой к проекту

• Фильтрация по статусу: получение списка задач с фильтрацией по статусу «В ожидании» (Pending) или «Выполнено» (Completed)

• Настройка через переменные окружения: безопасное управление аутентификацией PocketBase через файл .env

• Простое тестирование: наличие эндпоинта для проверки работоспособности и поддержка MCP Inspector

Related MCP server: Todoist MCP Server

⚡ Быстрый старт

# 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

Ваш сервер теперь запущен по адресу http://localhost:3000!

Проверьте его: откройте http://localhost:3000/health в браузере.

🚀 Начало работы

1. Предварительные требования

• Node.js (v18+)

• PocketBase, запущенный локально по адресу http://127.0.0.1:8090

• Токен супер-администратора PocketBase.

2. Установка

npm install

3. Конфигурация

Создайте файл .env в корне проекта:

PB_AUTH_TOKEN=your_super_admin_token_here

🛠️ Разработка и отладка

Сборка проекта

Компиляция кода TypeScript в JavaScript:

npm run build

Запуск HTTP-сервера

Запуск сервера локально:

node dist/index.js

Сервер запустится по адресу http://localhost:3000 (или на порту, указанном в вашем файле .env).

Вы должны увидеть вывод, похожий на этот:

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

Тестирование сервера

Посетите эндпоинт проверки работоспособности в браузере:

http://localhost:3000/health

Вы должны увидеть:

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

Дополнительная настройка порта

Добавьте в файл .env для изменения порта:

PORT=3000
PB_AUTH_TOKEN=your_super_admin_token_here

📖 Доступные инструменты

• list_projects: получение всех проектов и их ID.

• create_task: создание новой задачи (требуются task_title, eta, status и project_id).

• list_tasks: получение списка всех задач с опциональной фильтрацией по статусу.

🧪 Тестирование инструментов

Вы можете протестировать MCP-сервер с помощью MCP Inspector или подключившись через HTTP-эндпоинт по адресу http://localhost:3000/mcp.

Использование MCP Inspector

npx @modelcontextprotocol/inspector

Затем подключитесь к: http://localhost:3000/mcp

🌐 Почему HTTP, а не Stdio?

Преимущества:

• Нет файлов конфигурации: не нужно редактировать claude_desktop_config.json или другие сложные конфигурации

• Легкое тестирование: простой доступ по URL через браузер или инструменты типа Postman

• Готовность к удаленной работе: можно развернуть на сервере и обращаться отовсюду

• Множество клиентов: несколько приложений могут подключаться одновременно

• Улучшенная отладка: легко отслеживать запросы и ответы с помощью стандартных HTTP-инструментов

Подключение из MCP-клиентов:

При использовании MCP-совместимых клиентов подключайтесь к:

http://localhost:3000/mcp

📝 Зависимости

• @modelcontextprotocol/sdk: базовая функциональность MCP

• pocketbase: JS SDK для PocketBase

• express: фреймворк для HTTP-сервера

• cors: промежуточное ПО для совместного использования ресурсов между разными источниками

• zod: валидация схем

• dotenv: управление переменными окружения