Moko Consulting

Open-source software for Joomla, Gitea, and web platforms. Home of MokoSuite, MokoGitea, and MokoCLI.

Tennessee
https://mokoconsulting.tech
Repositories
57
 Projects Packages Code Wiki Members
1
Repositories
57
 Projects Packages Code Wiki Members
1
architecture/mcp-server-architecture.-

MCP Server Architecture

Architecture for Model Context Protocol (MCP) servers used by Moko Consulting.

Overview

MCP servers extend AI assistants (Claude Code) with tools that interact with Moko Consulting infrastructure. Each server lives in a standalone repository (mcp-moko*).

Symlink Architecture

Local-only MCP servers are symlinked into mokoplatform for fleet coordination. API servers that access remote infrastructure are NOT symlinked for security.

A:/mokoplatform/mcp/servers/
  mokossh/       -> A:/mcp-mokossh/           # Symlinked (local)
  mokobackup/   -> A:/mcp-mokobackup/        # Symlinked (local)
  mokomonitor/  -> A:/mcp-mokomonitor/       # Symlinked (local)
  mokodreamhost/ -> A:/mcp-mokodreamhost/     # Symlinked (local)
  windows/      -> A:/mcp-windows/           # Symlinked (local)

A:/mcp-mokogitea-api/     # NOT symlinked (security)
A:/mcp-mokowaas-api/      # NOT symlinked (security)

Why the split?

mokogitea-api and mokosuite-api access remote infrastructure with API tokens. Keeping them out of the symlink tree:

  • Encourages proper npm run build usage in their own repos
  • Prevents accidental token exposure through the mokoplatform tree
  • Maintains clear security boundaries for remote API access

Server Inventory

Server Repo Build Symlinked Config
mokossh mcp-mokossh Plain JS Yes env vars
mokobackup mcp-mokobackup TypeScript Yes ~/.mcp_mokobackup.json
mokomonitor mcp-mokomonitor TypeScript Yes ~/.mcp_mokomonitor.json
mokodreamhost mcp-mokodreamhost TypeScript Yes ~/.mcp_mokodreamhost.json
windows mcp-windows TypeScript Yes none
mokogitea_api mcp-mokogitea-api npm run build No ~/.mcp_mokogitea.json
mokosuite_api mcp-mokowaas-api npm run build No ~/.mcp_mokosuite.json

Build

API servers (not symlinked) — build in their own repos:

cd A:/mcp-mokogitea-api && npm run build
cd A:/mcp-mokowaas-api && npm run build

Local servers (symlinked) — accessible via mokoplatform or their own repos.

Configuration

All MCP servers registered in ~/.claude/.mcp.json. Per-server configs at ~/.mcp_moko{name}.json.

Naming Conventions

  • Repo names: mcp-moko{service} (hyphens)
  • Tool names: {service}_{resource}_{action} (e.g., gitea_repo_get)
  • Config files: ~/.mcp_moko{service}.json
Pages