Ansible Ollama与mcphost部署工具

git clone https://github.com/Spectro34/ansible-ollama_mcphost.git
cd ansible-ollama_mcphost
ansible-playbook deploy.yml

git clone https://github.com/Spectro34/ansible-ollama_mcphost.git
cd ansible-ollama_mcphost
ANSIBLE_ROLES_PATH=$(pwd):${ANSIBLE_ROLES_PATH:-$HOME/.ansible/roles} \
  ansible-playbook your-playbook.yml

./deploy.sh

ansible-playbook deploy.yml

ansible-playbook deploy.yml \
  -e "mcp_servers=['filesystem','bash-commands']" \
  -e "model=qwen2.5:14b" \
  -e "gpu_enabled=true" \
  -e "gpu_runtime=cuda"

 When the script prompts you, answer **“y”** to auto-discover every server, or
 type the specific server names (e.g., `my-server,filesystem`) to enable only those.
 Tip: entering `risu-agent` automatically expands to
 `risu-agent-filesystem,risu-agent-bash`, so you only need to type the friendly alias once.

**Config File Format (`config.yml`):**
- Each `config.yml` should be in **mcphost's native format** - just the server configuration dictionary
- The file should contain only the server config, not wrapped in `mcpServers:` (the role handles that)
- Use `{{ server_dir }}` for paths relative to the server directory (automatically replaced)
- Use `${env://VAR_NAME}` for environment variable substitution in server environment variables
- The server name (key) should match the directory name or be unique
- See [roles/ansible-ollama_mcphost/mcp_servers/README.md](roles/ansible-ollama_mcphost/mcp_servers/README.md) for detailed examples

**API Keys:**
- **Recommended:** Use Ansible Vault to encrypt API keys in playbooks or variable files
```bash
# Create encrypted variable file
ansible-vault create group_vars/all/vault.yml
# Add: mcphost_provider_api_key: "your-encrypted-key"

# Or encrypt inline in playbook
mcphost_provider_api_key: !vault |
        $ANSIBLE_VAULT;1.1;AES256
        6638643965396631613264626361396530...

ansible-playbook examples/sle16-example.yml

mcphost_mcp_servers:
  - name: "filesystem_tmp"
    type: "builtin"
    builtin_name: "fs"  # Required: "fs", "bash", or "http"
    options:  # Optional: server-specific options
      allowed_directories: ["/tmp", "/home/user/documents"]
    allowed_tools:  # Optional: restrict available tools
      - "read_file"
      - "write_file"
      - "list_directory"

mcphost_mcp_servers:
  - name: "monitor"
    type: "local"
    command: ["mcp-server-monitor"]  # Required: command and arguments
    cwd: "/opt/monitor"  # Optional: working directory
    environment:  # Optional: environment variables
      DEBUG: "true"
      API_KEY: "${env://MCP_API_KEY}"  # Use environment variable substitution
    description: "System monitoring server"  # Optional: description

mcphost_mcp_servers:
  - name: "remote-server"
    type: "remote"
    url: "https://api.example.com/mcp"  # Required: server URL
    description: "Remote MCP server"  # Optional: description

# examples/sle16-example.yml
- hosts: localhost
  become: true
  roles:
    - role: ansible-ollama_mcphost
      sle16_mcp_repo_enabled: true
      ollama_model: "gpt-oss:20b"
      mcphost_mcp_servers:
        - name: "filesystem"
          type: "builtin"
          builtin_name: "fs"
          options:
            allowed_directories: ["/tmp"]

# examples/openai-example.yml
- hosts: localhost
  roles:
    - role: ansible-ollama_mcphost
      ollama_state: absent
      mcphost_model_provider: "openai"
      mcphost_model_name: "gpt-4"
      mcphost_provider_url: "https://api.openai.com/v1"
      # Set API key via environment variable: export OPENAI_API_KEY="your-key"
      mcphost_mcp_servers:
        - name: "filesystem"
          type: "builtin"
          builtin_name: "fs"
          options:
            allowed_directories: ["/tmp"]

# examples/remote-server-example.yml
- hosts: localhost
  roles:
    - role: ansible-ollama_mcphost
      mcphost_mcp_servers:
        - name: "filesystem"
          type: "builtin"
          builtin_name: "fs"
          options:
            allowed_directories: ["/tmp"]
        - name: "remote-server"
          type: "remote"
          url: "https://api.example.com/mcp"
          description: "Remote MCP server"

- hosts: localhost
  roles:
    - role: ansible-ollama_mcphost
      ollama_model: "gpt-oss:20b"
      mcphost_mcp_servers:
        - name: "filesystem"
          type: "builtin"
          builtin_name: "fs"
          options:
            allowed_directories: ["/tmp"]

- hosts: gpu-servers
  become: true
  roles:
    - role: ansible-ollama_mcphost
      ollama_gpu_enabled: true
      ollama_gpu_runtime: "cuda"  # or "rocm"
      ollama_pull_models:
        - "qwen2.5:32b"
        - "gpt-oss:20b"
      mcphost_temperature: 0.3
      mcphost_max_tokens: 8192

- hosts: localhost
  roles:
    - role: ansible-ollama_mcphost
      ollama_state: absent
      mcphost_model_provider: "openai"
      mcphost_model_name: "gpt-4"
      mcphost_provider_api_key: "{{ vault_openai_api_key }}"  # From Ansible Vault

- hosts: localhost
  roles:
    - role: ansible-ollama_mcphost
      mcphost_mcp_servers:
        - name: "filesystem"
          type: "builtin"
          builtin_name: "fs"
          options:
            allowed_directories: ["/tmp"]
        - name: "monitor"
          type: "local"
          command: ["mcp-server-monitor"]
        - name: "remote-api"
          type: "remote"
          url: "https://api.example.com/mcp"

# Deploy with every bundled MCP server (RISU agent included)
ansible-playbook deploy.yml

# Limit the deployment to only the RISU agent helpers
ansible-playbook deploy.yml \
  -e "mcp_servers=['risu-agent-filesystem','risu-agent-bash']"

- hosts: localhost
  become: true
  roles:
    - role: ansible-ollama_mcphost
      ollama_gpu_enabled: true          # Optional
      ollama_gpu_runtime: "rocm"        # or "cuda"
      mcphost_mcp_servers_auto_discover: true
      # RISU agent servers are discovered automatically from
      # roles/ansible-ollama_mcphost/mcp_servers/risu-agent/
      # Set RISU_AGENT_ROOT to point at a different checkout if needed.

- hosts: sle16-servers
  become: true
  roles:
    - role: ansible-ollama_mcphost
      sle16_mcp_repo_enabled: true
      ollama_model: "gpt-oss:20b"
      mcphost_mcp_servers:
        - name: "filesystem"
          type: "builtin"
          builtin_name: "fs"
          options:
            allowed_directories: ["/tmp"]