OpenCode Docs MCP Server

A Mintlify-style MCP server that enables AI models to search and browse the OpenCode documentation.

✨ Features

• Full-text search across 33+ documentation pages

• Category browsing (Getting Started, Usage, Configure, Develop)

• Page retrieval with full markdown content

• Auto-discovery of documentation pages from navigation

• Auto-updating index that refreshes every 24 hours

• Mintlify-style tool descriptions and responses

Related MCP server: OpenTelemetry Documentation MCP Server

🚀 Quick Start

Option 1: Remote Server (Recommended - No Installation)

Just add a URL to your MCP config:

{
  "mcpServers": {
    "opencode-docs": {
      "name": "opencode-docs",
      "url": "https://tryinspector.com/api/opencode-docs/mcp",
      "headers": {}
    }
  }
}

Option 2: NPX (Local)

{
  "mcpServers": {
    "opencode-docs": {
      "command": "npx",
      "args": ["-y", "opencode-docs-mcp"]
    }
  }
}

⚠️ Using nvm, fnm, or volta? You need the full path to npx:

# Find your npx path
which npx
# Example: /Users/you/.nvm/versions/node/v20.19.5/bin/npx

Then use the full path in your config:

{
  "mcpServers": {
    "opencode-docs": {
      "command": "/Users/you/.nvm/versions/node/v20.19.5/bin/npx",
      "args": ["-y", "opencode-docs-mcp"]
    }
  }
}

Option 3: Global Install

npm install -g opencode-docs-mcp

{
  "mcpServers": {
    "opencode-docs": {
      "command": "opencode-docs-mcp"
    }
  }
}

📦 MCP Client Configuration

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "opencode-docs": {
      "name": "opencode-docs",
      "url": "https://tryinspector.com/api/opencode-docs/mcp",
      "headers": {}
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "opencode-docs": {
      "url": "https://tryinspector.com/api/opencode-docs/mcp"
    }
  }
}

OpenCode

Add to your opencode.json:

{
  "mcp": {
    "opencode-docs": {
      "type": "remote",
      "url": "https://tryinspector.com/api/opencode-docs/mcp"
    }
  }
}

🛠 Available Tools

📚 Documentation Categories

📝 Example Usage

Once connected, AI models can use the tools like:

User: "How do I configure MCP servers in OpenCode?"

AI calls: SearchOpenCodeDocs({ query: "configure MCP servers" })

Returns:
### 1. [MCP servers](https://opencode.ai/docs/mcp-servers/)
**Category:** Configure

Add external tools to OpenCode using the Model Context Protocol...

🌐 Self-Hosting

Deploy to Vercel

The remote server endpoint can be added to any Next.js project. See the source for the API route implementation.

Run Locally

git clone https://github.com/anthropics/opencode-docs-mcp
cd opencode-docs-mcp
npm install
npm run build
npm run scrape  # Pre-populate the docs index
npm start

🔧 Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Re-scrape docs
npm run scrape

# Run locally
npm start

🤝 Contributing

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

📄 License

MIT - see LICENSE for details.

🔗 Links

• OpenCode Documentation

• Model Context Protocol

• OpenCode GitHub

• npm Package