clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 43
colibri/docs/wiki/sl/external-mcp.md
Sam & Claude b8d499e85c
Some checks are pending
CI / rust (pull_request) Waiting to run
Details
CI / markdown (pull_request) Waiting to run
Details
CI / port (pull_request) Waiting to run
Details
CI / agent-jail-pkgs (pull_request) Waiting to run
Details
docs: rename PLAN/PROPOSAL/HANDOFF/ENHANCEMENT → implementation names 
7 renames (no plan/proposal/handoff/enhancement in filenames):

    CLAWDIE-INSTALLER-HANDOFF.md → CLAWDIE-INSTALLER-VALIDATION.md
    CLAWDIE-STUDIO-PROPOSAL.md   → CLAWDIE-STUDIO.md
    COLIBRI-SKILLS-PLAN.md       → COLIBRI-SKILLS.md
    FREEBSD-BUILD-LANE-HANDOFF.md→ FREEBSD-BUILD-LANE.md
    GLASSPANE-TUI-ENHANCEMENTS.md→ GLASSPANE-TUI-DESIGN.md
    MULTI-AGENT-HOST-PLAN.md     → MULTI-AGENT-HOST.md
    PLAN-WIKI-CLAWDIE-SI.md      → WIKI-CLAWDIE-SI.md

  16 cross-references updated across 10 files.
  wiki-lint --strict: PASS (146 refs, 0 failures).
2026-06-26 17:32:39 +02:00

2.8 KiB
Raw Blame History

title description
Zunanji MCP Most MCP za urejevalnike in zunanje gostitelje — branje, pisanje in dovoljenja za zunanje klice prek Colibrijeve implementacije MCP.

← kazalo

Colibri izpostavlja podmnožico svoje krmilne ravnine kot strežnik MCP (Model Context Protocol), tako da lahko zunanji urejevalniki (VS Code, Zed), agentski okviri (Claude Code, Hermes) in skripte komunicirajo z Colibrijem prek standardiziranega protokola.

→ crates/colibri-mcp/src/lib.rs

Odločitve

stdio, ne HTTP

Strežnik MCP komunicira prek standardnega vhoda/izhoda (stdio), ne prek HTTP ali WebSocket. To je standardni prenos MCP — vsak odjemalec MCP ga podpira. Prav tako se izogne potrebi po odprtju drugega omrežnega vmesnika.

Tri orodja, ne celoten API

Strežnik MCP izpostavlja tri orodja:

Orodje Ukaz procesa v ozadju Namen
colibri_status status Stanje procesa v ozadju (agenti, opravila, predpomnilnik)
colibri_snapshot glasspane-snapshot Trenutni posnetek podoken Glasspane
colibri_spawn spawn-agent Zaženi novega agenta

Ta tri orodja pokrivajo 90 % zunanjih interakcij. Celoten API vtičnice je na voljo neposrednim odjemalcem vtičnice; MCP je priročna podmnožica.

Ovoj Bash, ne vgrajeni proces

colibri-mcp je skripta Bash, ki se poveže na vtičnico procesa v ozadju, pošlje ukaz JSON in vrne odgovor JSON. Ni dolgotrajen proces — vsak klic zažene novo skripto. To pomeni, da je ničelna konfiguracija za odjemalce MCP (samo registrirajte pot skripte) in ničelno vzdrževanje stanja.

→ packaging/freebsd/colibri-mcp

Preverjanje za branje/pisanje in zunanje klice

Implementacija MCP ločuje tri skrbi:

  • Branje: status, snapshot — samo za branje, vedno na voljo.
  • Pisanje: spawn — spremeni stanje procesa v ozadju. Zaščiteno z zastavico allow_write v konfiguraciji MCP.
  • Zunanji klic: katerokoli orodje lahko sproži verigo MCP, ki sega navzven do drugega strežnika MCP. Zaščiteno z zastavico allow_external_call.

→ crates/colibri-mcp/src/config.rs

Inicializacijski manifest ob zagonu

Vsak strežnik MCP mora ob zagonu vrniti manifest initialize. Colibrijev manifest deklarira svoja tri orodja, zmogljivost tools in prazno zmogljivost resources. Odjemalci, ki ne pokličejo initialize, dobijo napako protokola.

→ crates/colibri-mcp/src/protocol.rs (initialize)

Glej tudi