{"id":22460,"library":"tidewave","title":"Tidewave","description":"Tidewave is an MCP (Model Context Protocol) server and library for JavaScript/TypeScript frameworks (Next.js, TanStack, Vite). It provides CLI and programmatic interfaces to expose project context to AI agents. Current stable version 0.6.0, released weekly, requires Node >=18 or Bun >=1.0. Ships TypeScript types. Differentiators: deep integration with modern JS frameworks, lightweight, and supports both stdio and HTTP transport.","status":"active","version":"0.6.0","language":"javascript","source_language":"en","source_url":"https://github.com/tidewave-ai/tidewave_js","tags":["javascript","typescript","documentation","mcp","cli","tidewave","next","vite","tanstack"],"install":[{"cmd":"npm install tidewave","lang":"bash","label":"npm"},{"cmd":"yarn add tidewave","lang":"bash","label":"yarn"},{"cmd":"pnpm add tidewave","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency required for type definitions and compilation of configuration files.","package":"typescript","optional":true}],"imports":[{"note":"Tidewave is a named export, not default. Use named import.","wrong":"import Tidewave from 'tidewave'","symbol":"Tidewave","correct":"import { Tidewave } from 'tidewave'"},{"note":"The MCP server functions are in a subpath export. Import from 'tidewave/mcp'.","wrong":"import { startMcpServer } from 'tidewave'","symbol":"startMcpServer","correct":"import { startMcpServer } from 'tidewave/mcp'"},{"note":"The CLI entry point is exported from 'tidewave/cli'. Not available in the main package.","symbol":"cli","correct":"import { cli } from 'tidewave/cli'"}],"quickstart":{"code":"import { Tidewave } from 'tidewave';\n\nconst tw = new Tidewave({\n  projectPath: process.cwd(),\n  prefix: process.env.TIDEWAVE_PREFIX ?? ''\n});\n\nasync function main() {\n  const context = await tw.getProjectContext();\n  console.log('Project context:', context);\n}\nmain();","lang":"typescript","description":"Initialize Tidewave with project path and optional prefix, then retrieve project context for AI agents."},"warnings":[{"fix":"Update to v0.2.3 or later.","message":"In v0.2.0, project evaluation scoped tool introduced, changing the tool schema. Older tools may not be compatible.","severity":"breaking","affected_versions":">=0.2.0 <0.2.3"},{"fix":"Use `projectPath` instead of `config`.","message":"The `config` flag was renamed to `projectPath` in v0.1.0. Old flag no longer works.","severity":"deprecated","affected_versions":"<0.1.0"},{"fix":"Check the CLI documentation for prefix usage; programmatic users ignore prefix.","message":"The `prefix` option is only applied at the CLI layer. If using programmatic API, you must handle prefixes manually.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Update any custom HTTP handlers to use the `/tidewave` prefix.","message":"In v0.2.0, HTTP paths were changed to `/tidewave` prefix. Custom paths may break.","severity":"breaking","affected_versions":">=0.2.0"},{"fix":"Upgrade to v0.2.0+ or use HTTP transport.","message":"Stdio MCP server (v0.1.0) is experimental and may have issues with large project contexts.","severity":"gotcha","affected_versions":">=0.1.0 <0.2.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Install package: `npm install tidewave` and ensure TypeScript is present (`npm install --save-dev typescript`).","cause":"Missing import or no TypeScript types installed.","error":"Cannot find module 'tidewave' or its corresponding type declarations."},{"fix":"Change import to: `import { startMcpServer } from 'tidewave/mcp'`","cause":"Importing from wrong subpath.","error":"The requested module 'tidewave' does not provide an export named 'startMcpServer'"},{"fix":"Use `projectPath` instead.","cause":"Using deprecated `config` option.","error":"Error: config is not a valid option. Did you mean projectPath?"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}