@breadstone/archipel-mcp

MCP (Model Context Protocol) server that provides Archipel platform knowledge - documentation and query patterns - to AI development tools. The server acts as a structured knowledge provider: AI models combine this knowledge with the user's project context to generate framework-compliant code.

Usage

VS Code MCP Configuration

Add to your .vscode/mcp.json (or global settings.json):

{
  "servers": {
    "archipel": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@breadstone/archipel-mcp"]
    }
  }
}

Direct Execution

npx @breadstone/archipel-mcp

Tools

| Tool | Description | | ------------------- | -------------------------------------------------------------------------------------------- | | list-packages | Lists all Archipel platform packages with descriptions and tags. | | get-package-doc | Returns the full documentation (overview + API reference) for a specific package. | | search-docs | Searches across all documentation by keyword or phrase. | | get-query-pattern | Returns the v1 query pattern docs (interfaces, factories, rules). Optionally model-tailored. |

get-query-pattern

Returns the complete Archipel v1 query pattern: IRepositoryQuery interface, query() factory, QueryResultType, transactional queries, rules, and usage examples. When a modelName and fields array are provided, it generates tailored findFirst, findMany, and count query examples for that model.

modelName?: string   - Prisma model name (e.g. "User")
fields?: string[]    - Field names (e.g. ["id", "email", "name", "createdAt"])

Architecture

Plain Node.js MCP server using @modelcontextprotocol/sdk. No NestJS, no DI container.

flowchart TB
  MainTs[main.ts\nCLI entry\nstdio transport + tool registration]
  DocsLoader[DocsLoader.ts\nLoads and indexes .docs/packages]
  GuidesLoader[GuidesLoader.ts\nLoads and indexes .docs/guides]
  PatternsLoader[PatternsLoader.ts\nLoads and indexes .docs/patterns]

  subgraph Models[models/]
    IPackageDoc[IPackageDoc.ts\nPackage documentation interface]
    IGuideDoc[IGuideDoc.ts\nGuide documentation interface]
    IPatternDoc[IPatternDoc.ts\nPattern documentation interface]
  end

  subgraph Generators[generators/]
    QueryGenerator[queryPatternGenerator.ts]
    RepositoryGenerator[repositoryPatternGenerator.ts]
    MappingGenerator[mappingPatternGenerator.ts]
    ModuleGenerator[modulePatternGenerator.ts]
  end

  MainTs --> DocsLoader
  MainTs --> GuidesLoader
  MainTs --> PatternsLoader
  DocsLoader --> IPackageDoc
  GuidesLoader --> IGuideDoc
  PatternsLoader --> IPatternDoc

Documentation Resolution

The server locates docs in this order:

1. Bundled data - <package>/data/packages/ (shipped with the npm package)
2. Workspace root - <cwd>/.docs/packages/ (monorepo development)
3. Relative fallback - walks up from compiled source to find .docs/packages/

Development

# Build
npx nx build mcp-server

# Run locally (from workspace root)
node dist/tools/mcp/src/main.js

License

See LICENSE.