# 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.
Raw data
{
"_id": null,
"home_page": null,
"name": "aci-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "hanyi <support@aipolabs.xyz>",
"keywords": "aci, aipolabs, function calling, llm, mcp, mcp server, tool calling",
"author": null,
"author_email": "Aipolabs <support@aipolabs.xyz>",
"download_url": "https://files.pythonhosted.org/packages/a2/9f/b3e222672263ff06088feb17dd24b3af4dce8a88cadcb35bcd607d766669/aci_mcp-1.0.0b13.tar.gz",
"platform": null,
"description": "# MCP servers powered by [ACI.dev](https://aci.dev)\n\n> [!IMPORTANT]\n> 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).\n\n## Table of Contents\n\n- [MCP servers powered by ACI.dev](#mcp-servers-powered-by-acidev)\n - [Table of Contents](#table-of-contents)\n - [Overview](#overview)\n - [Run MCP Servers Locally](#run-mcp-servers-locally)\n - [Integration with MCP Clients](#integration-with-mcp-clients)\n - [Docker](#docker)\n - [Debugging](#debugging)\n\n## Overview\n\nThis package provides three Model Context Protocol (MCP) servers for accessing [ACI.dev](https://aci.dev) managed functions (tools):\n\n- `aci-mcp-apps`: An MCP server that provides direct access to functions (tools) from specified apps\n <img src=\"./assets/apps-mcp-server-diagram.svg\" alt=\"Apps Server\"/>\n- `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)\n <img src=\"./assets/unified-mcp-server-diagram.svg\" alt=\"Unified Server\">\n\n> [!IMPORTANT]\n> For detailed explanation and tutorials on the MCP servers please visit [aci.dev docs](https://aci.dev/docs/mcp-servers/introduction).\n\n## Run MCP Servers Locally\n\nThe package is published to PyPI, so you can run it directly using `uvx`:\n\n```bash\n# Install uv if you don't have it already\ncurl -sSf https://install.pypa.io/get-pip.py | python3 -\npip install uv\n```\n\n```bash\n$ uvx aci-mcp --help\nUsage: aci-mcp [OPTIONS] COMMAND [ARGS]...\n\n Main entry point for the package.\n\nOptions:\n --help Show this message and exit.\n\nCommands:\n apps-server Start the apps-specific MCP server to access tools...\n unified-server Start the unified MCP server with unlimited tool access.\n```\n\n## Integration with MCP Clients\n\nSee 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.\n\n## Docker\n\n```bash\n# Build the image\ndocker build -t aci-mcp .\n\n# Run the unified server\ndocker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>\n\n# Run the apps server\ndocker 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>\n```\n\n## Debugging\n\nYou can use the MCP inspector to debug the server:\n\n```bash\n# For unified server\nnpx @modelcontextprotocol/inspector uvx aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>\n\n# For apps server\nnpx @modelcontextprotocol/inspector uvx aci-mcp apps-server --apps \"BRAVE_SEARCH,GMAIL\" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>\n```\n\nRunning `tail -n 20 -f ~/Library/Logs/Claude/mcp*.log` will show the logs from the server and may help you debug any issues.\n",
"bugtrack_url": null,
"license": null,
"summary": "ACI MCP server, built on top of ACI.dev by Aipolabs",
"version": "1.0.0b13",
"project_urls": null,
"split_keywords": [
"aci",
" aipolabs",
" function calling",
" llm",
" mcp",
" mcp server",
" tool calling"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ba5e1a6a1e7ce8243da4a36f9ca94cb0fcb026e106cb3d86b70f49b7dc1aac82",
"md5": "39fe78a0f33f7e66c884875f567249c6",
"sha256": "2d5f091f899e21f9183830635a5ba11d725a8055658b67696862f9c5eac36086"
},
"downloads": -1,
"filename": "aci_mcp-1.0.0b13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "39fe78a0f33f7e66c884875f567249c6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 13430,
"upload_time": "2025-08-01T17:19:20",
"upload_time_iso_8601": "2025-08-01T17:19:20.438559Z",
"url": "https://files.pythonhosted.org/packages/ba/5e/1a6a1e7ce8243da4a36f9ca94cb0fcb026e106cb3d86b70f49b7dc1aac82/aci_mcp-1.0.0b13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a29fb3e222672263ff06088feb17dd24b3af4dce8a88cadcb35bcd607d766669",
"md5": "43eb2bb9fb8939b0ef717c0fc46ced30",
"sha256": "ed474038522485459791ea0390567ce64638d87361c0c711ce3aef41bb191a11"
},
"downloads": -1,
"filename": "aci_mcp-1.0.0b13.tar.gz",
"has_sig": false,
"md5_digest": "43eb2bb9fb8939b0ef717c0fc46ced30",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 596942,
"upload_time": "2025-08-01T17:19:21",
"upload_time_iso_8601": "2025-08-01T17:19:21.910599Z",
"url": "https://files.pythonhosted.org/packages/a2/9f/b3e222672263ff06088feb17dd24b3af4dce8a88cadcb35bcd607d766669/aci_mcp-1.0.0b13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-01 17:19:21",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "aci-mcp"
}
JSON