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

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

# 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: управление переменными окружения

PocketBase Task MCP Server