Skip to content
Back to search

aci-mcp

MCP server(s) for Aipolabs ACI.dev

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aipotheosis-labs--aci-mcp/badge.svg)](/listings/aipotheosis-labs--aci-mcp)

HTML

<a href="/listings/aipotheosis-labs--aci-mcp"><img src="/api/listings/aipotheosis-labs--aci-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 81 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP servers powered by [ACI.dev](https://aci.dev)
  2. > [!IMPORTANT]
  3. > 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).
  4. ## Table of Contents
  5. - [MCP servers powered by ACI.dev](#mcp-servers-powered-by-acidev)
  6. - [Table of Contents](#table-of-contents)
  7. - [Overview](#overview)
  8. - [Run MCP Servers Locally](#run-mcp-servers-locally)
  9. - [Integration with MCP Clients](#integration-with-mcp-clients)
  10. - [Docker](#docker)
  11. - [Debugging](#debugging)
  12. ## Overview
  13. This package provides three Model Context Protocol (MCP) servers for accessing [ACI.dev](https://aci.dev) managed functions (tools):
  14. - `aci-mcp-apps`: An MCP server that provides direct access to functions (tools) from specified apps
  15. <img src="./assets/apps-mcp-server-diagram.svg" alt="Apps Server"/>
  16. - `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)
  17. <img src="./assets/unified-mcp-server-diagram.svg" alt="Unified Server">
  18. > [!IMPORTANT]
  19. > For detailed explanation and tutorials on the MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction).
  20. ## Run MCP Servers Locally
  21. The package is published to PyPI, so you can run it directly using `uvx`:
  22. ```bash
  23. # Install uv if you don't have it already
  24. curl -sSf https://install.pypa.io/get-pip.py | python3 -
  25. pip install uv
  26. ```
  27. ```bash
  28. $ uvx aci-mcp --help
  29. Usage: aci-mcp [OPTIONS] COMMAND [ARGS]...
  30. Main entry point for the package.
  31. Options:
  32. --help Show this message and exit.
  33. Commands:
  34. apps-server Start the apps-specific MCP server to access tools...
  35. unified-server Start the unified MCP server with unlimited tool access.
  36. ```
  37. ## Integration with MCP Clients
  38. 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.
  39. ## Docker
  40. ```bash
  41. # Build the image
  42. docker build -t aci-mcp .
  43. # Run the unified server
  44. docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>
  45. # Run the apps server
  46. 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>
  47. ```
  48. ## Debugging
  49. You can use the MCP inspector to debug the server:
  50. ```bash
  51. # For unified server
  52. npx @modelcontextprotocol/inspector uvx aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>
  53. # For apps server
  54. npx @modelcontextprotocol/inspector uvx aci-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>
  55. ```
  56. Running `tail -n 20 -f ~/Library/Logs/Claude/mcp*.log` will show the logs from the server and may help you debug any issues.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.