All-in-One MCP server for AI agents

AIO-MCP Server is a powerful implementation of the Model Context Protocol (MCP) that enhances AI interactions with integrations for various services including GitLab, Jira, Confluence, YouTube, and more. It provides AI-powered search capabilities and utility tools that can be used to improve development workflows and information retrieval.

Installation Options

Installing via Smithery

The easiest way to install AIO-MCP Server for Claude Desktop is through Smithery:

npx -y @smithery/cli install @athapong/aio-mcp --client claude

Smithery will guide you through an interactive CLI setup process, prompting for required configuration values and handling the environment setup automatically.

Installing via Go

To install using Go, you need to properly set up your Go environment variables first:

Linux/macOS:

Add the following to your shell config file (.bashrc, .zshrc, etc.):

export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

Then reload your shell configuration:

source ~/.bashrc  # or ~/.zshrc

Windows (PowerShell):

[Environment]::SetEnvironmentVariable("GOPATH", "$env:USERPROFILE\go", "User")
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\go\bin", "User")

Windows (Command Prompt):

setx GOPATH "%USERPROFILE%\go"
setx PATH "%PATH%;%USERPROFILE%\go\bin"

Once your environment is set up, install the server:

go install github.com/athapong/aio-mcp@latest

Configuration

Environment Setup

Create a .env file with your configuration:

ENABLE_TOOLS=
QDRANT_HOST=
ATLASSIAN_HOST=
ATLASSIAN_EMAIL=
GITLAB_HOST=
GITLAB_TOKEN=
BRAVE_API_KEY=
ATLASSIAN_TOKEN=
GOOGLE_AI_API_KEY=
PROXY_URL=
OPENAI_API_KEY=
OPENAI_EMBEDDING_MODEL=
DEEPSEEK_API_KEY=
QDRANT_PORT=
GOOGLE_TOKEN_FILE=
GOOGLE_CREDENTIALS_FILE=
QDRANT_API_KEY=
USE_OLLAMA_DEEPSEEK=
ENABLE_SSE=
SSE_ADDR=
SSE_BASE_PATH=

Claude Desktop Configuration

Configure your Claude Desktop by adding to claude_desktop_config.json:

{
  "mcpServers": {
    "aio-mcp": {
      "command": "aio-mcp",
      "args": ["-env", "/path/to/.env", "-sse", "-sse-addr", ":8080", "-sse-base-path", "/mcp"]
    }
  }
}

Alternatively, you can override environment values directly:

{
  "mcpServers": {
    "aio-mcp": {
      "command": "aio-mcp",
      "env": {
        "ENABLE_TOOLS": "",
        "OPENAI_BASE_URL": "",
        "GOOGLE_AI_API_KEY": "",
        "GITLAB_TOKEN": "",
        "GITLAB_HOST": "",
        "QDRANT_HOST": "",
        "QDRANT_API_KEY": "",
        "PROXY_URL": "",
        "OPENAI_API_KEY": "",
        "GOOGLE_TOKEN_FILE": "",
        "GOOGLE_CREDENTIALS_FILE": "",
        "ATLASSIAN_TOKEN": "",
        "BRAVE_API_KEY": "",
        "QDRANT_PORT": "",
        "ATLASSIAN_HOST": "",
        "ATLASSIAN_EMAIL": "",
        "USE_OPENROUTER": "",
        "DEEPSEEK_API_KEY": "",
        "OPENROUTER_API_KEY": "",
        "DEEPSEEK_API_BASE": "",
        "USE_OLLAMA_DEEPSEEK": "",
        "OLLAMA_URL": ""
      }
    }
  }
}

Server Modes

AIO-MCP Server supports two operation modes:

Stdio Mode (Default)

The server communicates via standard input/output, which is the default mode used by Claude Desktop and other MCP clients.

SSE (Server-Sent Events) Mode

The server runs as an HTTP server that supports Server-Sent Events for real-time communication. Enable SSE mode using either:

Command-line flags:

aio-mcp -sse -sse-addr ":8080" -sse-base-path "/mcp"

Environment variables (in your .env file):

ENABLE_SSE=true
SSE_ADDR=:8080
SSE_BASE_PATH=/mcp

When SSE mode is enabled, the server provides two endpoints:

SSE endpoint: {SSE_BASE_PATH}/sse (default: /mcp/sse)
Message endpoint: {SSE_BASE_PATH}/message (default: /mcp/message)

Tool Configuration

The ENABLE_TOOLS environment variable controls which tool groups are available. It accepts a comma-separated list of tool groups to enable. Leave it empty to enable all tools.

Available tool groups:

gemini: Gemini-powered search
fetch: Fetch tools
brave_search: Brave Search tools
google_maps: Google Maps tools
confluence: Confluence tools
youtube: YouTube tools
jira: Jira tools
gitlab: GitLab tools
script: Script tools
rag: RAG tools
deepseek: Deepseek AI tools

Using the Tools

AIO-MCP Server provides numerous tools that can be used with compatible AI clients. Here are some key tools grouped by functionality:

Google Calendar Tools

calendar_create_event: Create a new event
calendar_list_events: List upcoming events
calendar_update_event: Update an existing event
calendar_respond_to_event: Respond to an event invitation

Confluence Tools

confluence_search: Search Confluence with CQL
confluence_get_page: Get page content
confluence_create_page: Create a new page
confluence_update_page: Update an existing page
confluence_compare_versions: Compare page versions

Fetch and Search Tools

get_web_content: Fetch content from a URL
ai_web_search: Use Google AI Search for real-time information
web_search: Search using Brave Search API

GitLab Tools

gitlab_list_projects: List projects
gitlab_get_project: Get project details
gitlab_list_mrs: List merge requests
gitlab_create_mr: Create a new merge request
gitlab_get_file_content: Get file content from a repository

Jira Tools

jira_get_issue: Get issue details
jira_search_issue: Search for issues using JQL
jira_create_issue: Create a new issue
jira_update_issue: Modify an existing issue
jira_transition_issue: Move an issue through its workflow

Memory and RAG Tools

RAG_memory_create_collection: Create a new vector collection
RAG_memory_index_content: Index content into memory
RAG_memory_search: Search for memory in a collection
RAG_memory_list_collections: List all vector collections

Utility Tools

execute_comand_line_script: Safely execute command line scripts
sequentialthinking: Tool for dynamic problem-solving
tool_use_plan: Create a plan using available tools

YouTube Tools

youtube_transcript: Get video transcript
youtube_update_video: Update a video's details
youtube_list_videos: List videos managed by the user

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "aio-mcp" '{"command":"aio-mcp","args":["-env","/path/to/.env","-sse","-sse-addr",":8080","-sse-base-path","/mcp"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "aio-mcp": {
            "command": "aio-mcp",
            "args": [
                "-env",
                "/path/to/.env",
                "-sse",
                "-sse-addr",
                ":8080",
                "-sse-base-path",
                "/mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "aio-mcp": {
            "command": "aio-mcp",
            "args": [
                "-env",
                "/path/to/.env",
                "-sse",
                "-sse-addr",
                ":8080",
                "-sse-base-path",
                "/mcp"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect