MCP servers powered by

by aipotheosis-labs

251 stars
216 downloads
Not rated
GitHub

About

An MCP server package providing two servers (apps-server and unified-server) for accessing ACI.dev managed functions (tools) via the Model Context Protocol. Designed for developers integrating ACI.dev capabilities into MCP-compatible clients.

Details

Author
aipotheosis-labs
GitHub stars
251
Downloads
216
Categories
Other

- Two servers: apps-specific and unified access
- Apps-server gives direct access to functions from specified apps
- Unified-server provides meta functions (ACI_SEARCH_FUNCTIONS, ACI_EXECUTE_FUNCTION)
- Available via PyPI, runnable with uvx or Docker
- Debuggable with MCP inspector and log files

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP servers powered by
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via uvx and run either aci-mcp apps-server or aci-mcp unified-server. Configure with --linked-account-owner-id and optionally --apps (for apps-server). Require ACI_API_KEY as environment variable. Also supports Docker deployment.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp servers powered by": {
            "aci-mcp": {
                "command": "uvx",
                "args": [
                    "aci-mcp",
                    "--help"
                ]
            }
        }
    }
}

McpServers

{
    "aci-mcp": {
        "command": "uvx",
        "args": [
            "aci-mcp",
            "--help"
        ]
    }
}
# MCP servers powered by [ACI.dev](https://aci.dev) > [!IMPORTANT] > This README only covers basic development guide. For full documentation and tutorials on ACI.dev MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction). ## Table of Contents - [MCP servers powered by ACI.dev](#mcp-servers-powered-by-acidev) - [Table of Contents](#table-of-contents) - [Overview](#overview) - [Run MCP Servers Locally](#run-mcp-servers-locally) - [Integration with MCP Clients](#integration-with-mcp-clients) - [Docker](#docker) - [Debugging](#debugging) ## Overview This package provides three Model Context Protocol (MCP) servers for accessing [ACI.dev](https://aci.dev) managed functions (tools): - `aci-mcp-apps`: An MCP server that provides direct access to functions (tools) from specified apps <img src="./assets/apps-mcp-server-diagram.svg" alt="Apps Server"/> - `aci-mcp-unified`: An MCP server that provides two meta functions (tools) (`ACI_SEARCH_FUNCTIONS` and `ACI_EXECUTE_FUNCTION`) to discover and execute **ALL** functions (tools) available on [ACI.dev](https://platform.aci.dev) <img src="./assets/unified-mcp-server-diagram.svg" alt="Unified Server"> > [!IMPORTANT] > For detailed explanation and tutorials on the MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction). ## Run MCP Servers Locally The package is published to PyPI, so you can run it directly using `uvx`: ```bash # Install uv if you don't have it already curl -sSf https://install.pypa.io/get-pip.py | python3 - pip install uv ``` ```bash $ uvx aci-mcp --help Usage: aci-mcp [OPTIONS] COMMAND [ARGS]... Main entry point for the package. Options: --help Show this message and exit. Commands: apps-server Start the apps-specific MCP server to access tools... unified-server Start the unified MCP server with unlimited tool access. ``` ## Integration with MCP Clients See the [Unified MCP Server](https://www.aci.dev/docs/mcp-servers/unified-server#integration-with-mcp-clients) and [Apps MCP Server](https://www.aci.dev/docs/mcp-servers/apps-server#integration-with-mcp-clients) sections for more information on how to configure the MCP servers with different MCP clients. ## Docker ```bash # Build the image docker build -t aci-mcp . # Run the unified server docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> # Run the apps server docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp apps-server --apps <APP1,APP2,...> --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> ``` ## Debugging You can use the MCP inspector to debug the server: ```bash # For unified server npx @modelcontextprotocol/inspector uvx aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> # For apps server npx @modelcontextprotocol/inspector uvx aci-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> ``` Running `tail -n 20 -f ~/Library/Logs/Claude/mcp*.log` will show the logs from the server and may help you debug any issues.
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.