docs(mcp): regenerate mcp-tools diagram for 43 tools (+ notion); fix count in CLAUDE.md

release/v3.8.8 added notionTools.ts (6 tools) → MCP total is 43, not 37, but the
diagram asset (mcp-tools-43.svg) was never generated and MCP-SERVER.md/CLAUDE.md
still said 37. Create mcp-tools-43.{mmd,svg} (rendered via mermaid-cli), repoint
MCP-SERVER.md + docs/diagrams/README.md, update CLAUDE.md count to 43, and remove
the superseded mcp-tools-37 source/asset.

Note: full 'next build' OOM'd locally (session cgroup limit); the SVG ref resolves
(file present at path) and check:docs-sync passes — CI runs the authoritative build.
This commit is contained in:
diegosouzapw
2026-06-01 00:15:20 -03:00
parent a0b435bcae
commit 74e290bc70
6 changed files with 15 additions and 7 deletions

View File

@@ -47,7 +47,7 @@ For full test matrix, see `CONTRIBUTING.md` → "Running Tests". For deep archit
| Services | `open-sse/services/` | Combo routing, rate limits, caching, etc |
| Database | `src/lib/db/` | SQLite domain modules (45+ files, 55 migrations) |
| Domain/Policy | `src/domain/` | Policy engine, cost rules, fallback logic |
| MCP Server | `open-sse/mcp-server/` | 37 tools (30 base + 3 memory + 4 skills), 3 transports, ~13 scopes |
| MCP Server | `open-sse/mcp-server/` | 43 tools (30 base + 3 memory + 4 skills + 6 notion), 3 transports, ~13 scopes |
| A2A Server | `src/lib/a2a/` | JSON-RPC 2.0 agent protocol |
| Skills | `src/lib/skills/` | Extensible skill framework |
| Memory | `src/lib/memory/` | Persistent conversational memory |

View File

@@ -16,7 +16,7 @@ Mermaid sources (`.mmd`) and exported SVGs for OmniRoute v3.8.0 architecture flo
| [auto-combo-9factor.mmd](./auto-combo-9factor.mmd) | [SVG](./exported/auto-combo-9factor.svg) | docs/routing/AUTO-COMBO.md |
| [resilience-3layers.mmd](./resilience-3layers.mmd) | [SVG](./exported/resilience-3layers.svg) | docs/architecture/RESILIENCE_GUIDE.md, CLAUDE.md |
| [i18n-flow.mmd](./i18n-flow.mmd) | [SVG](./exported/i18n-flow.svg) | docs/guides/I18N.md |
| [mcp-tools-37.mmd](./mcp-tools-37.mmd) | [SVG](./exported/mcp-tools-37.svg) | docs/frameworks/MCP-SERVER.md |
| [mcp-tools-43.mmd](./mcp-tools-43.mmd) | [SVG](./exported/mcp-tools-43.svg) | docs/frameworks/MCP-SERVER.md |
| [cloud-agent-flow.mmd](./cloud-agent-flow.mmd) | [SVG](./exported/cloud-agent-flow.svg) | docs/frameworks/CLOUD_AGENT.md |
| [authz-pipeline.mmd](./authz-pipeline.mmd) | [SVG](./exported/authz-pipeline.svg) | docs/architecture/AUTHZ_GUIDE.md |
| [db-schema-overview.mmd](./db-schema-overview.mmd) | [SVG](./exported/db-schema-overview.svg) | docs/architecture/CODEBASE_DOCUMENTATION.md |

File diff suppressed because one or more lines are too long

Before

Width:  |  Height:  |  Size: 32 KiB

File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 42 KiB

View File

@@ -1,10 +1,11 @@
%% MCP Server tool inventory by category
%% Reflects: open-sse/mcp-server/tools/* and docs/MCP-SERVER.md
%% v3.8.0
%% v3.8.8
flowchart LR
MCP["MCP Server<br/>37 tools total"] --> Core["Core (30)"]
MCP["MCP Server<br/>43 tools total"] --> Core["Core (30)"]
MCP --> Mem["Memory (3)"]
MCP --> Skl["Skills (4)"]
MCP --> Notion["Notion (6)"]
Core --> Essential["Essential (8)<br/>get_health, list_combos,<br/>switch_combo, check_quota,<br/>route_request, cost_report,<br/>list_models_catalog,<br/>get_combo_metrics"]
Core --> Search["Search (1)<br/>web_search"]
@@ -21,3 +22,10 @@ flowchart LR
Skl --> S2["skill_list"]
Skl --> S3["skill_diagnose"]
Skl --> S4["skill_uninstall"]
Notion --> N1["notion_search"]
Notion --> N2["notion_get_page"]
Notion --> N3["notion_query_database"]
Notion --> N4["notion_get_database"]
Notion --> N5["notion_list_block_children"]
Notion --> N6["notion_append_blocks"]

View File

@@ -10,9 +10,9 @@ lastUpdated: 2026-05-30
>
> Source of truth: `open-sse/mcp-server/schemas/tools.ts` (30 tools) + `open-sse/mcp-server/tools/memoryTools.ts` (3 tools) + `open-sse/mcp-server/tools/skillTools.ts` (4 tools) + `open-sse/mcp-server/tools/notionTools.ts` (6 tools). Tool registration and scope wiring lives in `open-sse/mcp-server/server.ts`.
![MCP tool inventory by category](../diagrams/exported/mcp-tools-37.svg)
![MCP tool inventory (43 tools by category)](../diagrams/exported/mcp-tools-43.svg)
> Source: [diagrams/mcp-tools-37.mmd](../diagrams/mcp-tools-37.mmd). ⚠️ The rendered diagram still shows 37 tools — it predates the 6 `notionTools` (total of record is **43**, per the source-of-truth breakdown above). Regenerate `mcp-tools-43.{mmd,svg}` to refresh.
> Source: [diagrams/mcp-tools-43.mmd](../diagrams/mcp-tools-43.mmd) (regenerate via `npm run docs:render-diagrams`).
## Installation