pullini-mcp

A local stdio MCP connector that lets an agent create, read, update, delete and share Pullini artifacts over the authenticated artifact REST API.

The connector runs on the agent's machine. It reads its configuration from the environment and needs no ASGI or OAuth infrastructure on the Pullini host (decision D-25).

Install

Runs with uv, no install step required:

uvx pullini-mcp

Or install it into an environment:

uv tool install pullini-mcp   # or: pip install pullini-mcp

Configure

Two environment variables:

The token is sent as Authorization: Bearer <token>; all resources are scoped to the token's owner. Treat the raw secret like a password.

MCP client config

The client launches the server and passes the two variables. A copy-paste example lives in mcp.example.json.

From a local checkout (before the package is published): point --directory at the mcp/ folder of your clone.

{
  "mcpServers": {
    "pullini": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/pullini/mcp", "pullini-mcp"],
      "env": {
        "PULLINI_URL": "http://localhost:8000",
        "PULLINI_TOKEN": "pln_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyy"
      }
    }
  }
}

From PyPI (once published):

{
  "mcpServers": {
    "pullini": {
      "command": "uvx",
      "args": ["pullini-mcp"],
      "env": {
        "PULLINI_URL": "https://pullini.example.com",
        "PULLINI_TOKEN": "pln_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyy"
      }
    }
  }
}

Tools

content is Markdown; fenced ```mermaid blocks render as diagrams. Artifacts are private by default: share_artifact returns a read-only share_url anyone with the link can open, and revoking clears it.

Development

uv sync
uv run ruff check .
uv run ruff format --check .
uv run pytest

Tests mock the HTTP transport with httpx.MockTransport, so no Pullini host is needed.