Использование Headless MCP (из реестра) с Next.js

Использует @vercel/mcp-adapter с настраиваемым реестром MCP

Развернутый URL-адрес

Это приложение развернуто по адресу: https://nextjs-mcp-use.vercel.app

Related MCP server: Example Next.js MCP Server

Функции

• Реестр MCP : настройка нескольких серверов MCP в одном файле JSON

• Действия GitHub : тестирование и мониторинг конечных точек API с помощью запланированных и ручных рабочих процессов.

• Обработка ошибок : плавная обработка тайм-аутов и сбоев соединения.

• Переменные среды : настройка переменных среды для каждого сервера MCP.

Реестр МКП

Реестр MCP — это файл конфигурации JSON, в котором хранится информация обо всех доступных серверах MCP. Каждый сервер может быть включен или отключен и может иметь собственные переменные среды.

Реестр находится по адресу config/mcp-registry.json и имеет следующую структуру:

{
  "server-name": {
    "url": "http://localhost:3002/sse",
    "enabled": true,
    "env": {
      "API_KEY": "your-api-key"
    }
  },
  "another-server": {
    "url": "https://example.com/sse",
    "enabled": false
  }
}

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

В этом примере приложения используется адаптер Vercel MCP , который позволяет вам добавить сервер MCP в группу маршрутов в любом проекте Next.js.

Обновите app/[transport]/route.ts добавив в него свои инструменты, подсказки и ресурсы, следуя документации MCP TypeScript SDK .

Конечные точки API

• API чата : /api/chat — конечная точка потокового чата

• API завершений : /api/completions — конечная точка завершений чата без потоковой передачи

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

Вы можете протестировать конечные точки API, используя предоставленный тестовый скрипт:

# Test the chat endpoint
npm run test:chat -- --message "Your message here"

# Test the completions endpoint
npm run test:completions -- --message "Your message here"

# Test with a custom URL
npm run test:chat -- --url http://localhost:3000/api/chat --message "Your message here"

Действия GitHub

Этот проект включает рабочие процессы GitHub Actions для тестирования и мониторинга конечных точек API. Для получения дополнительной информации см. файл .github/workflows/README.md .

Заметки для бега на Vercel

• Для использования транспорта SSE требуется Redis, подключенный к проекту в process.env.REDIS_URL

• Убедитесь, что у вас включены вычисления Fluid для эффективного выполнения

• После включения вычислений Fluid откройте app/route.ts и установите maxDuration на 800, если вы используете учетную запись Vercel Pro или Enterprise.

• Разверните шаблон Next.js MCP

Образец клиента

• scripts/test-client.mjs содержит пример клиента для пробных вызовов.

node scripts/test-client.mjs https://nextjs-mcp-use.vercel.app