blendsdk-mcp

MCP (Model Context Protocol) server providing AI agents with intelligent, context-efficient access to BlendSDK documentation, usage patterns, project scaffolding templates, and API references.

Features

• 13 specialized MCP tools for querying BlendSDK documentation
• In-memory TF-IDF search across all documentation
• Per-package documentation covering all 12+ BlendSDK packages
• Getting-started guides — installation, project scaffolding, Docker, production
• How-to patterns — CRUD, authentication, caching, database, plugins, codegen, email, i18n
• Architecture docs — dependency graph, project structure, design patterns
• Code examples — extracted from documentation, ready to use
• Project templates — 5 scaffolding blueprints for common project types
• Package suggestions — "what packages do I need for X?"
• Implementation guides — step-by-step plans for development goals

Installation

npm install -g blendsdk-mcp

Usage

As a global MCP server

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

With custom docs path

{
  "mcpServers": {
    "blendsdk-docs": {
      "command": "blendsdk-mcp",
      "env": {
        "BLENDSDK_MCP_DOCS_PATH": "/path/to/custom/docs"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | query_package | Get complete documentation for a specific BlendSDK package | | search_docs | Full-text search across all documentation | | list_packages | List all BlendSDK packages with descriptions | | get_guide | Get getting-started guide documentation | | get_pattern | Get how-to pattern documentation | | get_architecture | Get architecture documentation | | get_examples | Extract code examples from package docs | | get_api_reference | Get API reference with imports and key types | | suggest_packages | Suggest packages for a described use case | | get_implementation_guide | Generate step-by-step implementation plan | | scaffold_project | Get project template for a specific project type | | list_all_docs | List all indexed documentation entries | | reindex | Rebuild the documentation index |

Development

# Build
yarn build

# Run tests
yarn test

# Watch mode
yarn test:watch

# Start the server locally
yarn start

License

MIT — TrueSoftware B.V.