Skip to content

Conversation

@kazukinakai
Copy link
Collaborator

@kazukinakai kazukinakai commented Dec 13, 2025

Summary

Adds AIRIS MCP Gateway as the recommended MCP setup method in the MCP Servers documentation.

What this provides

  • 60+ tools from 13 default servers via single SSE endpoint
  • Lazy loading - servers start only when needed, auto-terminate when idle
  • HOT/COLD server management - token optimization

Installation

git clone https://github.com/agiletec-inc/airis-mcp-gateway.git
cd airis-mcp-gateway
docker compose up -d
claude mcp add --scope user --transport sse airis-mcp-gateway http://localhost:9400/sse

Included servers

Server Mode Description
airis-agent HOT Confidence check, deep research, repo indexing
memory HOT Knowledge graph
context7 COLD Library documentation
sequential-thinking COLD Step-by-step reasoning
serena COLD Semantic code retrieval
tavily COLD Web search
playwright COLD Browser automation
magic COLD UI components
morphllm COLD Code editing
chrome-devtools COLD Chrome debugging

Related Issues

Changes

  • docs/user-guide/mcp-servers.md - Add gateway setup instructions
  • src/superclaude/mcp/MCP_Airis-Agent.md - Recommend gateway
  • src/superclaude/mcp/MCP_Mindbase.md - Recommend gateway
  • src/superclaude/mcp/configs/airis-agent.json - Add deprecation notice
  • src/superclaude/mcp/configs/mindbase.json - Add deprecation notice

🤖 Generated with Claude Code

Adds airis-mcp-gateway as an alternative MCP setup method that provides:
- Single SSE endpoint for all MCP servers
- HOT/COLD server management for token optimization
- Lazy loading (servers start on-demand)
- Unified tool discovery
- Web UI for management

This addresses the complexity of managing multiple MCP servers and
provides token-efficient operation through selective tool advertising.

Repository: github.com/agiletec-inc/airis-mcp-gateway

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Replace outdated docker-compose.dist.yml method with quick-install.sh
- Fix Claude Code registration command: use --transport sse instead of npx mcp-remote
- Update feature list: 27+ tools, 75-90% token reduction, 120s idle timeout
- Add verification commands (health check, tools count)
- Update HOT/COLD server examples with actual server names
- Add AIRIS Suite reference (airis-agent, mindbase, airis-workspace)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Update mcp-servers.md: remove quick-install.sh, use git clone + docker compose
- Update MCP_Airis-Agent.md: recommend gateway, list current tools
- Update MCP_Mindbase.md: recommend gateway, list current tools
- Add deprecation notice to airis-agent.json and mindbase.json configs
- Change airis-agent config from Docker to uvx

All airis components (airis-agent, mindbase) are now included in airis-mcp-gateway.
Individual installation is deprecated in favor of the unified gateway.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Copy link
Member

@mithun50 mithun50 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks man

@mithun50 mithun50 merged commit 6ae5e99 into SuperClaude-Org:master Dec 15, 2025
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG] Issue with Installing MCP Server "tavily" - Invalid Environment Variable Format Confused about Airis MCP

2 participants