gmr/copa

A Claude Code plugin that exposes a local Osaurus server-side agent as a single MCP tool over stdio.

About copa

A Claude Code plugin that exposes a local Osaurus server-side agent as a single MCP tool over stdio.

1. .mcp.json runs server/osaurusagent.py directly. The !/usr/bin/env -S uv run --script shebang makes uv build and cache an isolated environment from the PEP 723 block in the file, so there is no virtualenv to manage. 2. On the first tool call the server calls GET /agents and matches OSAURUSAGENT by name to get the agent UUID and its defaultmodel. Set OSAURUSAGENTID to skip the lookup. 3. The tool is named after the agent, so OSAURUSAGENT=Rhona exposes askrhona(prompt, sessionid). 4. Conversation history is kept in memory per sessionid and resent on each call, trimmed to the last OSAURUSHISTORYTURNS turns. 5. The history is posted to POST /agents/{id}/run with stream: true. Osaurus runs its own tool loop; the server consumes the SSE stream, keeps the choices[].delta.content text, and ignores execution hints. 6. The final text is returned to Claude Code and appended to the session transcript.

Edit the env block in .mcp.json, or set these in the shell that starts Claude Code.

Variable Default Purpose ------------------------ ----------------------------------- ------------------------------------------- OSAURUSBASEURL http://127.0.0.1:1337 Osaurus server OSAURUSAGENT agent Agent name; also names the tool OSAURUSAGENTID unset Agent UUID; skips name resolution OSAURUSMODEL agent defaultmodel Model override OSAURUSAPIKEY unset osk-v1 key; only for non-loopback servers OSAURUSHISTORYTURNS 20 Turns of history resent per call OSAURUSTRANSCRIPTDIR ${CLAUDEPLUGINDATA}/transcripts T

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/gmr--copa.html)

Related MCP servers