Alcatel Lucent Enterprise Aos Mcp Server

Deploy mcp and ssh servers

Docker images for aos_ssh and aos_mcp servers are availables:

• docker.io/foricher/ale-aos-ssh:[tag]
• docker.io/foricher/ale-aos-mcp:[tag]

Under deploy folder, the mcp server side is available with a docker compose deployment.

Update data\aos-ssh.json file with your switches host, user, password for ssh connections.

[ 
    { 
      "host": "host_or_ip_address1",
      "user": "user", 
      "password": "password"
    },
    { 
      "host": "host_or_ip_address2",
      "user": "user", 
      "password": "password",
      "port" : 22 //optional
    }
]

data\mcp_tools.yaml file describes tools used by LLM to run aos commands.

docker-compose.yaml file:

services:
  aos-ssh:
    image: docker.io/foricher/ale-aos-ssh:0.0.8
    ports:
      - "8210:8110"
    volumes:
      - ./data/aos-ssh.json:/app/data/aos-ssh.json
  aos-mcp:
    image: docker.io/foricher/ale-aos-mcp:0.0.8
    ports:
      - "8000:8000"
    environment:
      - AOS_SSH_URL=http://aos-ssh:8110
      - MCP_TRANSPORT=streamable-http
#      - MCP_TRANSPORT=sse
    volumes:
      - ./data:/app/data
    depends_on:
      - aos-ssh

Launch docker compose

 cd deploy
 docker compose up 

By default, mcp server is deployed with transport streamable-http

Use copilot with visual stdio code

Under your workspace, inside .vscode folder, put file mcp.json as below.

{
 "servers": {
   "aos": {
     "type": "http",
     "url": "http://<aos-mcp-host>:8000/mcp"
   }
 }
}

Use cursor with visual stdio code

Under your workspace, inside .cursor folder, put file mcp.json as below.

{
   "mcpServers": {
       "aos": {
           "url": "http://<aos-mcp-host>:8000/mcp"
       }
   }
}

Use gemini cli

put under .gemini folder, file 'settings.json' as below.

{
"mcpServers": {
  "aos": {
    "name": "AOS MCP Server",
    "description": "AOS MCP Server for managing AOS switches",
    "httpUrl": "http://<aos-mcp-host>:8000/mcp",
    "timeout" : 60000
  }
}
}

npx https://github.com/google-gemini/gemini-cli -m gemini-2.5-flash