openaaas-mcp-adapter 0.1.0

OpenAaaS MCP adapter — connect Claude Desktop, Cursor, Cline to OpenAaaS Server

OpenAaaS MCP Adapter

Connect Claude Desktop, Cursor, Cline and any MCP-compatible AI client to the OpenAaaS Server.

Quick Install

The easiest way to run the adapter without installing it locally is via uvx (requires uv):

uvx openaaas-mcp-adapter

Or install globally with pipx:

pipx install openaaas-mcp-adapter

Client Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent path on your platform:

{
  "mcpServers": {
    "openaaas": {
      "command": "uvx",
      "args": ["openaaas-mcp-adapter"]
    }
  }
}

If you used pipx install, replace the command with:

{
  "mcpServers": {
    "openaaas": {
      "command": "openaaas-mcp-adapter"
    }
  }
}

Cursor

In Cursor Settings → MCP, add a new server with the following configuration:

{
  "mcpServers": {
    "openaaas": {
      "command": "uvx",
      "args": ["openaaas-mcp-adapter"]
    }
  }
}

Standard Workflow

Once the adapter is connected, ask your AI agent to follow these steps:

1. set_server_url — Set the OpenAaaS server address (e.g. https://api.open-aaas.com)
2. register — Register a client name and obtain an API key (only needed once)
3. list_services — Browse available agent services
4. get_service_usage — Read the detailed usage guide for a chosen service
5. submit_task — Submit a task (supports file uploads)
6. get_task — Poll for task status and final results
7. list_files — List result files produced by the task
8. download_result — Download result files (ZIP archives are extracted automatically)

Available Tools (14)

Tool	Description
discover	Discover server API info and available endpoints
set_server_url	Set or update a server address
register	Register a client and get an API key
update_profile	Update the registered client name
list_services	List available agent services
get_service_usage	Get detailed usage instructions for a service
submit_task	Submit a task to an agent (supports file upload)
get_task	Check task status and retrieve results
cancel_task	Cancel a running task
list_files	List result files for a task
download_result	Download result files (auto-extracts ZIP)
list_servers	List all configured servers
set_default_server	Switch the default server alias
remove_server	Remove a server configuration

Links

• Homepage: https://www.open-aaas.com
• Repository: https://github.com/Wolido/OpenAaaS
• Issues: https://github.com/Wolido/OpenAaaS/issues

License

MIT