chore: create missing ToolRegistry YAML server definition files #20

New issue

Open

opened 2026-02-21 01:03:01 +00:00 by Clotho · 0 comments

Clotho commented

2026-02-21 01:03:01 +00:00

Member

Summary

The ToolRegistry service references YAML configuration files that do not exist in the repository:

resource_path('mcp/registry.yaml')
resource_path("mcp/servers/{$id}.yaml")

These files are expected to define server IDs, tool names, descriptions, and input schemas.

Problem

ToolRegistry::getServers() will fail silently or throw on missing config
No tool metadata is available without these files
CLAUDE.md documents YAML-based tool config but no examples exist

Required Files

resources/mcp/registry.yaml — master registry listing all servers
resources/mcp/servers/workspace-tools.yaml — workspace tool definitions
resources/mcp/servers/database-tools.yaml — database tool definitions
resources/mcp/servers/content-tools.yaml — content tool definitions

Example Format

id: database-tools
name: Database Tools
description: Read-only database access tools
tools:
  - name: query_database
    description: Execute read-only SQL SELECT query
    inputSchema:
      type: object
      required: [query]
      properties:
        query:
          type: string
          description: SQL SELECT query to execute
        explain:
          type: boolean
          description: Run EXPLAIN instead
          default: false

Files

resources/mcp/registry.yaml (create)
resources/mcp/servers/*.yaml (create)

## Summary The `ToolRegistry` service references YAML configuration files that do not exist in the repository: ```php resource_path('mcp/registry.yaml') resource_path("mcp/servers/{$id}.yaml") ``` These files are expected to define server IDs, tool names, descriptions, and input schemas. ## Problem - `ToolRegistry::getServers()` will fail silently or throw on missing config - No tool metadata is available without these files - CLAUDE.md documents YAML-based tool config but no examples exist ## Required Files - `resources/mcp/registry.yaml` — master registry listing all servers - `resources/mcp/servers/workspace-tools.yaml` — workspace tool definitions - `resources/mcp/servers/database-tools.yaml` — database tool definitions - `resources/mcp/servers/content-tools.yaml` — content tool definitions ## Example Format ```yaml id: database-tools name: Database Tools description: Read-only database access tools tools: - name: query_database description: Execute read-only SQL SELECT query inputSchema: type: object required: [query] properties: query: type: string description: SQL SELECT query to execute explain: type: boolean description: Run EXPLAIN instead default: false ``` ## Files - `resources/mcp/registry.yaml` (create) - `resources/mcp/servers/*.yaml` (create)