pinzonjulian/turbo-docs-mcp-server

Turbo Docs MCP Server

An MCP server to access up to date documentation for Turbo JS.

⚠️ This is Experimental Software

This MCP is in early development. It may contain bugs, have limited functionality, or undergo breaking changes without notice. Use at your own risk and expect potential instability.

Building the MCP Server

Prerequisites

• Node.js: Minimum version 18.0.0 or higher
• npm: Comes bundled with Node.js

Build Instructions

1. Clone this repository and navigate to the project directory
2. Install dependencies:

   npm install
   

3. Build the project using the provided script:

   npm run build
   

This will compile the TypeScript source code and create the executable in the build/ directory.

Usage

With Claude Desktop

1. First, build the MCP server following the instructions above
2. Follow the instructions at https://modelcontextprotocol.io/quickstart/user to add a new MCP server.
3. Add the following configuration:

{
  "mcpServers": {
    "Turbo-docs": {
      "command": "node",
      "args": ["/path/to/your/Turbo-docs-mcp-server/build/index.js"],
      "env": {}
    }
  }
}

3. Replace /path/to/your/Turbo-docs-mcp-server with the actual path to this project
4. Restart Claude Desktop
5. The Turbo documentation tools should now be available in your Claude conversations

With VS Code

1. Build the MCP server following the instructions above
2. Follow the instructions at https://code.visualstudio.com/docs/copilot/chat/mcp-servers
3. Using your preferred method based on the instructions above, configure the MCP server by pointing it to the built executable:

   {
    "Turbo-docs": {
        "type": "stdio",
        "command": "node",
        "args": [
            "path/to/your/Turbo-docs-mcp-server"
          ]
    }
   }
   

4. Replace path/to/your/Turbo-docs-mcp-server with the path to the index.js file built in step 1.
5. The Turbo documentation will be accessible through the MCP client interface

Troubleshooting

Claude

You may see the following errors when opening Claude after configuring the MCP:

MCP Turbo-docs: spawn node ENOENT (2)

Could not connect to MCP server Turbo-docs

MCP Turbo-docs: Server disconnected. For troubleshooting guidance [...]

This is because the path to the node executable can not be found. If that's the case, instead of "command": "node" use the complete path to the node. If you use mise it may be something like:

"command": "/Users/<YOUR USER NAME/.local/share/mise/installs/node/20.18.3/bin/node

Documentation Source

The Turbo documentation files included are copied from the official Turbo-site repository.

The next phase of exploration for this MCP could be to fetch the docs from the web to keep them up to date and store them locally for a set period of time.

All credit for the documentation content goes to the Turbo team and contributors.

Available Tools

This MCP server provides access to the complete Turbo documentation, organized into:

Handbook:

• Introduction
• Drive
• Page Refreshes
• Frames
• Streams
• Native
• Building with Turbo
• Installing Turbo

Reference:

• Attributes
• Drive
• Events
• Frames
• Streams

Each documentation section is available as a separate tool that can be called to retrieve the relevant content.