MCP Servers - Model Context Protocol

#sympozium #komunikacja #mcp

Koncepcja

MCP (Model Context Protocol) to protokół umożliwiający rozszerzanie możliwości agentów o zewnętrzne narzędzia. Sympozium integruje MCP jako first-class citizen z pełnym lifecycle management.

Architektura

MCPServer CRD → Controller
    ├── Managed: Deploy + Service + probe tools
    └── External: Just probe tools

SympoziumInstance.mcpServers[] → reference MCPServer
    ↓
AgentRun → Reconciler:
  1. Resolve MCPServer URLs (status.url)
  2. Create MCP ConfigMap (server configs)
  3. Add mcp-bridge sidecar to pod
    ↓
Agent Pod:
  ┌──────────┐  ┌──────────────┐  ┌──────────────┐
  │  Agent   │──│  MCP Bridge  │──│  MCP Server  │
  │          │  │  Sidecar     │  │  (remote)    │
  │ gh_*     │  │  Translates: │  │              │
  │ tools    │  │  tool call → │  │  GitHub API  │
  │          │  │  MCP protocol│  │              │
  └──────────┘  └──────────────┘  └──────────────┘

Tool namespacing

Problem: wiele MCP serwerów może mieć tool o tej samej nazwie.

Rozwiązanie: toolsPrefix - każde narzędzie z danego serwera dostaje prefix:

GitHub MCP (prefix: gh) → gh_create_issue, gh_list_repos
Jira MCP (prefix: jira) → jira_create_ticket, jira_search
Slack MCP (prefix: sl)  → sl_send_message, sl_list_channels

Tool filtering

toolsAllow: [create_issue]     # TYLKO te narzędzia (whitelist)
toolsDeny: [delete_repo]       # BLOKUJ te narzędzia (blacklist)

toolsDeny applied after toolsAllow - można pozwolić na all except specific.

Auto-discovery

Controller probeuje MCP server po deploy:

Wysyła MCP tools/list request
Odkrywa dostępne narzędzia
Aplikuje allow/deny filtry
Zapisuje w status.tools[]
Aktualizuje status.toolCount

Transport modes

stdio → HTTP adapter

Serwer MCP używa stdio (stdin/stdout). Controller automatycznie dodaje HTTP adapter:

Container: my-mcp-server --stdio
    ↓
HTTP adapter: wraps stdio → HTTP endpoint
    ↓
mcp-bridge sidecar connects via HTTP

HTTP (native)

Serwer MCP natywnie serwuje HTTP:

Container: my-mcp-server --port 8080
    ↓
mcp-bridge sidecar connects directly

Powiązane: MCPServer | SympoziumInstance | Przepływ danych i IPC

2.5 KiB Raw Blame History