FusionAL

by jrm-fusional

312 downloads
Not rated
GitHub

Description

Unified MCP gateway that loads 150+ AI tools into Claude Desktop via a single Docker command on Windows. Routes tool calls across specialized servers (Business Intelligence, API Hub, Content Automation, Intelligence) with centralized logging and governance. Built for teams…

About

Unified MCP gateway that loads 150+ AI tools into Claude Desktop via a single Docker command on Windows. Routes tool calls across specialized servers (Business Intelligence, API Hub, Content Automation, Intelligence) with centralized logging and governance. Built for teams without dedicated platform engineers.

Details

Author
jrm-fusional
Downloads
312
Categories
Productivity, AI, Automation, API, Other

- Loads 150+ AI tools into Claude Desktop with one Docker command.
- Aggregates multiple MCP servers behind a single gateway.
- Provides centralized logging, tool routing, and governance.
- Groups tools into sub-servers: Business Intelligence, API Integration Hub, Content Automation, Intelligence MCP.
- Designed for teams without platform engineering expertise.
- Runs on Windows via Docker.

Clone the repository and run docker compose up to start the gateway. Then add an entry to your claude_desktop_config.json using npx mcp-remote pointing to http://localhost:18009/mcp/ with --allow-http, and restart Claude Desktop.

🚀 FusionAL — Self-Hosted MCP Governance Gateway

Your team connected 10 MCP servers. Now what?
🌐fusional.dev• 📧jrm@fusional.com• 🗓️Book a Call

MCP is powerful. Enterprise MCP deployment is a different problem entirely.

Every server you connect loads its full tool manifest into Claude's context window before processing a single token of your request. At 84 tools across several servers, that's15,540 tokens consumed at session start— before your team has asked anything. At scale, that's cost, latency, and an audit surface nobody can explain to legal.

FusionAL is aself-hosted MCP governance gatewaythat sits between your AI clients and your tool servers. One endpoint. Central auth. Tool-level policy enforcement. Full audit trail. Deployable in a single Docker command — including on Windows, where MCP has 6 documented failure modes the official docs don't cover.

Built for teams that have already said yes to MCP and now need to run it safely:

- Token control— filter tool exposure per client so context bloat doesn't scale with your server count
- Audit-ready operations— every tool call logged with caller, input, latency, and response status
- Policy enforcement— control what tools run, for whom, and under what conditions
- Windows-hardened— 6 documented failure modes solved, none of which appear in official MCP docs
- AI-powered server generation— describe a tool in plain English, FusionAL builds and registers it
- Done-for-you option— we deploy, govern, and manage it for you

The question isn't whether to adopt MCP. It's whether your deployment will survive contact with your security team.

- Docker Desktop (installed and running)
- Claude Desktop
- Python 3.11+
- Git

git clone https://github.com/JRM-FusionAL/FusionAL.git cd FusionAL python -m venv venv source venv/bin/activate # macOS/Linux # venv\Scripts\activate # Windows pip install -r core/requirements.txt
cd core python -m uvicorn main:app --reload --port 8009

- Windows:C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Linux:~/.config/Claude/claude_desktop_config.json

⚠️Windows users:Do NOT use%APPDATA%in the path — Claude Desktop won't expand it. Hardcode the full path. Example:C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json

{ "mcpServers": { "fusional-gateway": { "url": "http://localhost:8009/sse" } } }

Step 4: Restart Claude Desktop & Test

Fully quit and reopen Claude Desktop. Open a new chat and try:

"Generate a Python MCP server that fetches the current weather for a given city."

FusionAL will generate, register, and run it automatically.

Build and run the full gateway in Docker:

docker build -t fusional . docker run -d -p 8089:8009 --name fusional fusional

Gateway available athttp://localhost:8089.

Claude Desktop / Any MCP Client │ ▼ (SSE or Streamable HTTP) FusionAL Gateway (:8009) │ ┌─────┴──────┐ ▼ ▼ FastAPI MCP Transport (/mcp) REST API ├── execute_code ├── generate_and_execute └── generate_mcp_project │ ▼ Docker Sandbox Executor (network isolated, memory capped) │ ▼ MCP Server Registry (JSON) ├── business-intelligence-mcp (:8101) ├── api-integration-hub (:8102) └── content-automation-mcp (:8103)

These servers ship with themcp-consulting-kitand are pre-registered in the FusionAL gateway:

cd ../mcp-consulting-kit docker compose up -d

- ✅ Network isolation (--network none)
- ✅ Memory limits (default 128 MB, configurable)
- ✅ Process limits (max 64 processes)
- ✅ Read-only filesystem (except/tmp)
- ✅ No privilege escalation
- ✅ Non-root user execution

Whenmcp-consulting-kit/showcase-servers/common/security.pyis present, the gateway enables:

- API key authentication on/execute,/register,/generate
- Rate limiting
- CORS configuration

FusionAL documents and solves 6 Windows MCP failure modes not covered in official docs:
-

The 60-Second Silence— Claude Desktop times out with zero error. Caused by Docker socket init lag.
Read the fix →

The BOM Trap— Notepad/VS Code injects a byte-order mark into JSON configs, silently breaking MCP.
Fix:
[System.IO.File]::WriteAllText(path, content, New-Object System.Text.UTF8Encoding($false))

The Backslash Trap— Windows path separators inclaude_desktop_config.jsonbreak startup silently.
Use forward slashes or escaped double backslashes.

%USERPROFILE%expansion— Claude Desktop does NOT expand env vars in config paths. Hardcode them.

Docker named pipe failure— Docker's named pipe transport fails on WSL2. Use/var/run/docker.sock.

Registry timeout at 8+ servers— Claude Desktop hits a timeout threshold on lower-end hardware.
Cap your registry at 8 servers on i5/i7 7th gen and below.

Using the AI Builder (via Claude Desktop)

"Generate an MCP server that queries our PostgreSQL database using natural language."

FusionAL generates the full project, builds it, and registers it in the gateway automatically.

my-server/ ├── Dockerfile ├── requirements.txt ├── my_server.py ← FastMCP tools go here └── .env

- Use@mcp.tool()decorators on async functions
- Single-line docstrings only (multi-line breaks some MCP clients)
- Return formatted strings from all tools
- Default parameters to""notNone
- Log tosys.stderr
- Run as non-root in Docker

from mcp.server.fastmcp import FastMCP import sys mcp = FastMCP("my-server") @mcp.tool() async def my_tool(query: str = "") -> str: """What this tool does in one line.""" return f"✅ Result for: {query}" if __name__ == "__main__": mcp.run(transport='stdio')

Don't want to self-manage? FusionAL offers done-for-you MCP deployments:

- New example servers
- Windows compatibility fixes
- Documentation improvements
- Test coverage

- Anthropic— Claude AI + MCP protocol
-
FastAPI— API framework
-
FastMCP— MCP server framework
-
Docker— Container infrastructure

Built by a self-taught developer who fixed the MCP problems nobody else documented.
🌐
fusional.dev• ⭐ Star the repo if it saved you hours

FusionAL started with a NetworkChuck video.

If you haven't watched"you need to learn MCP RIGHT NOW!!"— go watch it first. Chuck explains the fundamentals better than anyone, and hisdocker-mcp-tutorial repois the best starting point for understanding how MCP servers work with Docker.

The dice-roller example and quick-start structure in this repo are adapted from that tutorial (MIT licensed).

Chuck's tutorial shows you how to build MCP servers manually — edit a prompt template, paste it into Claude, implement the result yourself.

FusionAL removes the human from that loop entirely. Instead of a prompt file you copy-paste,generate_mcp_projectis a live tool call — Claude describes what it wants built, FusionAL generates it, registers it, and runs it. No clipboard. No manual steps.

More importantly, Chuck's video covers Docker's MCP catalog — 300+ servers you can enable with a click. That's step one. FusionAL is what you need when a CTO asks:

"Great — but how do we audit what those tools are doing? How do we enforce policy? How do we make sure this doesn't become a security incident?"

That's the gap FusionAL was built to fill: governance, auditability, and operational control for teams deploying MCP at scale — especially on Windows, where the catalog alone isn't enough.

Magica is your all-in-one AI platform, offering 2500+ cutting-edge tools under a single subscription.

Dynamically search and call tools using UnifAI Network

Connects AI agents to the SS&C Next Generation REST API to automate business processes.

Agentic pipeline that transforms ideas to revenue — for solo founders and bootstrappers.

The Most Comprehensive ServiceNow AI Toolkit — 400+ MCP tools, 26 AI capabilities, SDK mode, Direct API mode. Covers ITSM, ITOM, CMDB, HRSD, CSM, SecOps, GRC and 35+ modules.

200+ production tools for AI agents via Remote MCP. GitHub, Slack, Notion, Linear, Figma, Stripe, web search, OCR, document conversion, semantic memory/recall, Finviz, SEC filings, image generation, and more.

Create notes, search, & think with your Fabric AI workspace

Turn your Make scenarios into callable tools for AI assistants.

Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.

Connect your AI Agents to 8,000 apps instantly.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.