Arcanna MCP Server

🚀 Arcanna MCP Server

The Arcanna MCP Server enables users to interact with Arcanna's AI application scenarios through the Model Context Protocol (MCP).

🚀 Quick Start

Using Claude Desktop or Other MCP Clients

Configuration

Add the following entry to the mcpServers section of your MCP client configuration file (claude_desktop_config.json for Claude Desktop).

Using Docker Image (https://hub.docker.com/r/arcanna/arcanna-mcp-server) or PyPi Package (https://pypi.org/project/arcanna-mcp-server/)

Building a Local Image from This Repository

Prerequisites

• Docker - https://docs.docker.com/engine/install/

Configuration

1. Navigate to the directory containing the Dockerfile.
2. Run docker build -t arcanna/arcanna-mcp-server . --progress=plain --no-cache
3. Add the following configuration to your Claude Desktop/MCP client configuration.

{
  "mcpServers": {
    "arcanna-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ARCANNA_MANAGEMENT_API_KEY",
        "-e",
        "ARCANNA_HOST",
        "arcanna/arcanna-mcp-server"
      ],
      "env": {
        "ARCANNA_MANAGEMENT_API_KEY": "<ARCANNA_MANAGEMENT_API_KEY>",
        "ARCANNA_HOST": "<YOUR_ARCANNA_HOST_HERE>"
      }
    }
  }
}

✨ Features

• Resource Management: Create, update, and retrieve Arcanna resources (jobs, integrations).
• Python Coding: Generate, execute code, and save code blocks as Arcanna integrations.
• Query Arcanna Events: Query events processed by Arcanna with multiple filters available.
• Job Management: Create, retrieve, start, stop, and train jobs.
• Feedback System: Provide feedback on decisions to improve model accuracy.
• Health Monitoring: Check the status of the server and API keys.

🛠️ Tools

Query Arcanna Events

• query_arcanna_events
  • Used to obtain events processed by Arcanna, with multiple filters applicable.
• get_filter_fields
  • Serves as a helper tool (retrieves possible fields in Arcanna to apply filters).

Resource Management

• upsert_resources
  • Create or update Arcanna resources.
• get_resources
  • Retrieve Arcanna resources (jobs/integrations).
• delete_resources
  • Delete Arcanna resources.
• integration_parameters_schema
  • Serves as a helper tool in this context.

Python Coding

• generate_code_agent
  • Used to generate code.
• execute_code
  • Used to execute the generated code.
• save_code
  • Used to save code blocks as integrations in the Arcanna pipeline.

Job Management

• start_job
  • Start event ingestion for a job.
• stop_job
  • Stop event ingestion for a job.
• train_job
  • Train the AI model of a job using the provided feedback.

Feedback System

• add_feedback_to_event
  • Provide feedback on AI decisions to improve model accuracy.

System Health

• health_check
  • Verify the server status and the validity of the management API key.
  • Return the authorization status of the management API key.