convez.ai
MCP ServerDevOps & InfraestruturaAvançado
clempat

AI Tools Flake

clempat/ai-tools-flake

Configuração Nix unificada para Claude, OpenCode e MCP servers

Ver no GitHub
InicialPluginScore · de 0 a 100

Flake Nix unificado para configuração de ferramentas de IA, integrando Claude Code, OpenCode e MCP servers. Automatiza a instalação e configuração via home-manager, incluindo integração com Claude Desktop no macOS e suporte a MCP gateway para servidores HTTP.

Instalação

$npx convez-ai clempat/ai-tools-flake

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
8
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 1 semana
Versão
—
Issues abertas
5
Contribuidores
4

Casos de uso

  • Gerenciar múltiplas ferramentas de IA com uma única declaração Nix
  • Configurar MCP servers automaticamente para Claude Desktop
  • Integrar HTTP MCP servers via mcp-gateway proxy
  • Manter consistência de configuração de IA entre sistemas Linux/macOS

Veredito

Solução robusta e declarativa para quem usa NixOS/home-manager e quer gerenciar o ecossistema Claude/OpenCode com reproducibilidade. Reduz fricção operacional significativamente, mas exige familiaridade com Nix e flakes.

README

A tradução para o português deste README ainda está na fila.

AI Tools Flake

Unified Nix flake for AI tools configuration including Claude Code, OpenCode, MCP servers, and AI agents.

Features

  • Unified Module: Single home-manager module that configures both Claude Code and OpenCode
  • MCP Servers: Shared MCP server configurations across tools
  • Claude Desktop Integration: Auto-configures MCP servers for Claude Desktop on macOS
  • AI Agents: Reusable agent definitions with tool-specific metadata
  • Claude Skills: Pre-configured skills for various tasks
  • Claude-Flow Commands: Uses upstream programs.{opencode,claude-code}.commands options
  • Packages: Custom packages like spec-kit
  • Default Configurations: Sensible defaults that can be overridden per-system
  • Flexible Versioning: Control opencode/claude-code versions via flake follows or nixpkgs overlays

Requirements

  • home-manager: Must use unstable branch (programs.claude-code only in unstable)
  • nixpkgs: Recommends nixos-unstable (claude-code package)

Usage

As a Flake Input

Add to your flake.nix:

{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
    home-manager.url = "github:nix-community/home-manager";
    home-manager.inputs.nixpkgs.follows = "nixpkgs";
    
    ai-tools.url = "github:clempat/ai-tools-flake";
    ai-tools.inputs.nixpkgs.follows = "nixpkgs";  # Use your nixpkgs
  };

  outputs = { nixpkgs, home-manager, ai-tools, ... }: {
    homeConfigurations.youruser = home-manager.lib.homeManagerConfiguration {
      pkgs = nixpkgs.legacyPackages.x86_64-linux;
      modules = [
        ai-tools.nixosModules.default
        {
          programs.ai-tools.enable = true;
        }
      ];
    };
  };
}

Home Manager Integration

Basic Setup (Minimal)

{ inputs, ... }:
{
  imports = [ inputs.ai-tools.nixosModules.default ];

  programs.ai-tools.enable = true;
  
  # That's it! Automatically:
  # - Installs claude-code & opencode from nixpkgs-unstable
  # - Configures MCPs, agents, memory from config/
  # - Adds claude-flow commands
  # - Auto-configures Claude Desktop (macOS)
}

Override Package Versions

The module automatically uses packages from the flake. To override:

{ inputs, pkgs, ... }:
{
  imports = [ inputs.ai-tools.nixosModules.default ];

  programs.ai-tools.enable = true;
  
  # Optional: override package versions
  programs.opencode.package = inputs.opencode.packages.${pkgs.system}.default;
  programs.claude-code.package = pkgs.unstable.claude-code;
}

Claude Desktop Configuration (macOS)

On macOS, the module automatically configures Claude Desktop by generating ~/Library/Application Support/Claude/claude_desktop_config.json.

What's Auto-Configured:

  • ✅ stdio MCP servers (nixos, playwright) are automatically added to the config file
  • ✅ HTTP MCP servers via the mcp-gateway proxy (NEW!)

MCP Gateway (Automatic HTTP Support)

The flake includes an mcp-gateway package that acts as a stdio→HTTP proxy, allowing ALL your HTTP MCP servers to work with Claude Desktop automatically!

How it works:

  1. The gateway runs as a stdio MCP server (Claude Desktop compatible)
  2. It proxies requests to your HTTP MCP servers (atlassian, github, context7, etc.)
  3. All HTTP servers appear as tools in Claude Desktop

Generated config:

{
  "mcpServers": {
    "gateway": {
      "command": "/nix/store/.../bin/mcp-gateway",
      "env": {
        "MCP_GATEWAY_CONFIG": "~/.config/mcp-gateway/config.json"
      }
    },
    "nixos": {
      "command": "nix",
      "args": ["run", "github:utensils/mcp-nixos", "--"]
    }
  }
}

The gateway config (~/.config/mcp-gateway/config.json) is automatically generated from your config/mcps.nix HTTP servers.

Alternative: Manual Configuration

If you prefer manual configuration or the gateway doesn't work:

  1. Open Claude Desktop → Settings → Connectors
  2. Click "Add custom connector"
  3. Enter server URLs from config/mcps.nix
  4. Configure OAuth authentication if needed

Technical Details:

  • Gateway uses multi-mcp (Python-based)
  • Packaged as a Nix derivation with all dependencies
  • Config auto-generated from enabled HTTP servers in config/mcps.nix

Claude-Flow Commands

Automatically installed workflow commands:

  • commit: Create git commits
  • create_plan: Generate implementation plans
  • create_spec: Create feature specs
  • create_ticket: Generate Jira tickets
  • create_worktree: Create git worktrees
  • implement_plan: Execute implementation plans
  • research_codebase: Document codebases
  • research_confluence: Research Confluence docs
  • validate_plan: Validate implementation plans

Commands automatically configured via:

  • programs.opencode.commands
  • programs.claude-code.commands

Advanced: Direct Package Access

{
  # Access packages from the flake directly
  home.packages = [
    inputs.ai-tools.packages.${system}.opencode
    inputs.ai-tools.packages.${system}.claude-code
    inputs.ai-tools.packages.${system}.spec-kit
  ];
}

Advanced: Quick Shell (without home-manager)

nix develop github:clempat/ai-tools-flake
# Provides: opencode, claude-code, agent-browser (Linux), gh

Structure

ai-tools-flake/
├── flake.nix              # Main flake definition
├── modules/
│   └── ai-tools.nix       # Home-manager module
├── config/                # All configuration
│   ├── agents.nix         # Default agent configurations
│   ├── mcps.nix           # Default MCP server configurations
│   ├── memory.md          # Default memory/rules
│   ├── agents/            # Agent content markdown files
│   └── skills/            # Claude skills (plus pinned external inputs)
│       ├── agent-browser/
│       ├── gitea-tea/
│       ├── lint-with-conform/
│       ├── nixos-advisor/
│       └── nixos-command-not-found/
├── commands/              # Claude-flow workflow commands
│   ├── commit.md
│   ├── create_plan.md
│   ├── create_spec.md
│   ├── create_ticket.md
│   ├── create_worktree.md
│   ├── implement_plan.md
│   ├── research_codebase.md
│   ├── research_confluence.md
│   └── validate_plan.md
├── pkgs/
│   └── spec-kit.nix       # Spec-kit package
└── overlays/
    └── default.nix        # OpenCode wrapper overlay

Available Agents

  • frontend-developer: Vue.js, TypeScript, modern web dev
  • senior-code-reviewer: Code quality, architecture, security
  • ui-engineer: UI/UX, accessibility, design systems
  • nixos: NixOS configuration with MCP integration
  • ticket-driven-developer: Jira ticket-driven dev with spec-kit integration (requires gh CLI)

Available MCP Servers

  • nixos: NixOS packages and options
  • figma-desktop: Figma desktop integration
  • atlassian: Atlassian/Jira integration
  • github: GitHub integration
  • brave-search: Brave search
  • sentry: Sentry error tracking
  • n8n: n8n workflow automation
  • todoist: Todoist task management
  • playwright: Browser automation
  • refs: refs MCP documentation/search

Available Skills

  • homeassistant-ai/skills: Imported upstream skill catalog (as non-flake input)
  • lint-with-conform: Format files based on conform config
  • agent-browser: Browser automation workflows for agent-browser CLI
  • excalidraw-diagram: Generate Excalidraw .excalidraw diagrams from text specs
  • gitea-tea: Gitea workflows with tea CLI
  • nixos-advisor: NixOS configuration advice
  • obsidian-worklog: Obsidian worklog integration

License

MIT

Ver o original no GitHub

Bom para

Relacionados