pal-e-docs
Project not found.

Architecture: MCP Server (Paldocs)

arch-mcp Doc

architecture paldocs mcp
Project

Overview

MCP (Model Context Protocol) server for paldocs — thin JSON-RPC over stdio proxy that maps MCP tool calls to Rails API endpoints.

Architecture

  • Protocol: JSON-RPC over stdio (language-agnostic)
  • Server: New "paldocs" server replacing "pal-e-docs" (pal-e-mcp)
  • Transport: Tool call → HTTP request to Rails API → JSON response
  • Registration: ~/.mcp.json entry

Tool Surface

36 tools across 7 groups: Notes (12), Boards (6), Board Items (6), Projects (3), Repos (3), Tags (1), Search (2). Tool names use mcp__paldocs__* prefix.

Transition Strategy

  • New "paldocs" server runs alongside old "pal-e-docs"
  • Verify all 36 tools return matching results
  • Migrate tool references in claude-custom (hooks, agents, skills, settings)
  • Remove old server from ~/.mcp.json, archive pal-e-mcp repo
  • arch-rails-api — the API endpoints this server calls
  • arch-rails-views — separate concern (UI, not MCP)