jpytka666-jpg/aions-mcp-server

AIONS MCP Server

MCP (Model Context Protocol) server with 40+ tools for AI development workflows.

Quick Start

Option 1: Pull from GHCR

# Pull the image
docker pull ghcr.io/YOUR_USERNAME/aions-mcp-server:latest

# Run with docker-compose
docker-compose up -d

Option 2: Build Locally

git clone https://github.com/YOUR_USERNAME/aions-mcp-server.git
cd aions-mcp-server
docker build -t aions-mcp-server .
docker-compose up -d

MCP Client Configuration

Kiro / Claude Desktop

Add to your MCP config (~/.kiro/settings/mcp.json or .kiro/settings/mcp.json):

{
  "mcpServers": {
    "aions": {
      "command": "docker",
      "args": ["exec", "-i", "aions-mcp", "python", "-m", "src", "stdio"],
      "env": {}
    }
  }
}

Available Tools (40+)

Memory & Knowledge

• memory_store - Store context to memory
• memory_recall - Search memory by query
• cbms_search - Search CBMS knowledge chunks
• cbms_store - Store new knowledge chunk
• cbms_list - List CBMS chunks by concept
• cbms_get_chunk - Get chunk by K[hex] ID

File Search (Everything)

• fast_search - Blazing fast file search
• fast_search_ext - Search by file extension

Project Scanner

• project_scan_turbo - Fast project scan
• project_scan_status - Check scan status
• project_scan_results - Get scan results
• project_search - Search scanned files
• project_file_deps - Get file dependencies

Browser Automation

• browser_navigate - Navigate to URL
• browser_snapshot - Get page accessibility snapshot
• browser_click - Click element
• browser_type - Type into input
• browser_screenshot - Take screenshot
• browser_get_text - Get page text
• browser_evaluate - Execute JavaScript
• browser_close - Close browser

System Tools

• docker_ps - List Docker containers
• docker_images - List Docker images
• wsl_run - Run command in WSL
• wsl_list - List WSL distributions
• git_status - Get Git status
• git_log - Get recent commits
• network_ping - Ping a host
• system_health - System health check

Conversation Logging

• conv_log - Log message to buffer
• conv_dump - Force dump buffer
• conv_status - Check buffer status
• conv_set_threshold - Set auto-dump threshold
• conv_history - Get log history

MCP Discovery

• mcp_find - Search MCP servers catalog
• mcp_list - List available MCP servers
• mcp_info - Get MCP server details

Web

• web_fetch - Fetch URL content

Environment Variables

Data Persistence

Mount these volumes to persist data:

volumes:
  - aions-data:/app/data # ChromaDB, CBMS
  - aions-logs:/app/logs # Conversation dumps
  - aions-scans:/app/scan_results # Scanner output

Troubleshooting

Container won't start

docker logs aions-mcp

MCP connection issues

1. Ensure container is running: docker ps
2. Test manually: docker exec -i aions-mcp python -c "print('OK')"
3. Check MCP config path is correct

Tools not loading

Check server logs for import errors:

docker exec aions-mcp python -c "from src.server import mcp_server; print('OK')"

License

MIT