TanStack Start Devtools MCP

Локальный мост разработки между TanStack Devtools и агентами кодирования с поддержкой MCP.

Этот репозиторий представляет собой локальный инструментарий для клонирования и использования, а не опубликованный npm-пакет. См. INSTALL.md для получения инструкций по настройке и приглашения к установке агента.

Пакеты

• @barreloflube/tanstack-start-dev-tool-mcp-shared: общие схемы протоколов браузера/сервера.

• @barreloflube/tanstack-start-dev-tool-mcp-react: панель React для @tanstack/react-devtools.

• @barreloflube/tanstack-start-dev-tool-mcp-server: сервер MCP плюс локальный мост WebSocket.

Разработка

pnpm install
pnpm dev:mcp

pnpm dev:mcp использует tsx watch, поэтому изменения в сервере MCP автоматически перезапускают процесс.

Окружение

• TANSTACK_AGENT_DEVTOOLS_PORT: порт моста, по умолчанию 8129.

• TANSTACK_AGENT_DEVTOOLS_HOST: хост моста, по умолчанию 127.0.0.1.

• TANSTACK_AGENT_DEVTOOLS_TOKEN: общий токен браузера/сервера, по умолчанию tanstack-agent-devtools-local.

Конфигурация клиента MCP

Для клиентов на основе stdio:

{
  "mcpServers": {
    "tanstack-start-devtools": {
      "command": "/Users/barreloflube/Desktop/tanstack-start-dev-tool-mcp/node_modules/.bin/tsx",
      "args": [
        "/Users/barreloflube/Desktop/tanstack-start-dev-tool-mcp/packages/mcp-server/src/cli.ts"
      ],
      "env": {
        "TANSTACK_AGENT_DEVTOOLS_TOKEN": "tanstack-agent-devtools-local"
      }
    }
  }
}

Для клиентов stdio запускайте tsx напрямую вместо pnpm mcp; баннеры жизненного цикла менеджера пакетов могут повредить поток MCP JSON-RPC.

Codex запускает свой собственный процесс MCP. Остановите pnpm dev:mcp перед перезапуском Codex, если только вы намеренно не тестируете отслеживаемый сервер разработки.

Промпты, использованные для создания этого проекта

1. “i want to make a mcp server that allows the tanstack start dev tool's access to the agent. how should we go around making it”

2. “i want a sep personal repo for this.”

3. “you can make the sep repo in the Desktop/tanstack-start-dev-tool-mcp folder and work in there, import it here and start the mcp server test it, dont stop until it works, also support hmr for the mcp server so you can itereate quickly.”