yirifi-ops-mcp-hub 0.1.0

MCP servers for Yirifi Ops - expose REST APIs as MCP tools for AI assistants

yirifi-ops-mcp-hub

MCP (Model Context Protocol) servers for Yirifi Ops - expose REST APIs as MCP tools for AI assistants like Claude.

Installation

# Using pip
pip install yirifi-ops-mcp-hub

# Using uv (recommended)
uv pip install yirifi-ops-mcp-hub

Quick Start

Claude Code Configuration

Add to your Claude Code MCP settings (~/.claude.json or project .mcp.json):

{
  "mcpServers": {
    "yirifi-ops": {
      "command": "yirifi-ops-mcp",
      "env": {
        "YIRIFI_API_KEY": "your_api_key_here"
      }
    }
  }
}

CLI Options

# Run with all services (default)
YIRIFI_API_KEY=your_key yirifi-ops-mcp

# Run specific service
YIRIFI_API_KEY=your_key yirifi-ops-mcp --service=auth

# Development mode (localhost APIs)
YIRIFI_API_KEY=your_key yirifi-ops-mcp --mode=dev

# HTTP transport (for remote deployment)
yirifi-ops-mcp --transport=http --port=5200

Options:

• --service: all (default), auth, or reg
• --mode: dev (localhost) or prd (remote, default)
• --transport: stdio (default) or http
• --port: HTTP port (default: 5200)

Utility Commands

# List available tools
yirifi-ops-mcp list-tools

# Test API connection
yirifi-ops-mcp test-connection --service=auth

# Show OpenAPI spec
yirifi-ops-mcp show-spec --service=auth

Architecture

This package uses a tiered exposure system for safe AI access:

• DIRECT: Safe, frequent operations exposed as individual MCP tools
• GATEWAY: Admin/dangerous operations accessible via {service}_api_call gateway tool
• EXCLUDE: Internal endpoints never exposed

Environment Variables

• YIRIFI_API_KEY: API key for authentication (required)
• AUTH_SERVICE_API_KEY: Service-specific fallback for auth
• REG_SERVICE_API_KEY: Service-specific fallback for reg

License

MIT