MCP Server Catalog

AOF supports the Model Context Protocol (MCP) for extending agent capabilities with external tools and data sources. This catalog documents tested and recommended MCP servers.

What is MCP?

The Model Context Protocol is an open standard for connecting AI models to external data sources and tools. MCP servers provide:

• Tools: Functions the agent can invoke (e.g., query database, fetch URL)
• Resources: Data the agent can read (e.g., files, database schemas)
• Prompts: Pre-defined prompt templates

Using MCP Servers with AOF

Configuration

Add MCP servers to your agent or daemon configuration:

apiVersion: aof.sh/v1alpha1
kind: Agent
metadata:
  name: my-agent
spec:
  model: google:gemini-2.5-flash
  mcp_servers:
    - name: filesystem
      command: npx
      args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/files"]
    - name: github
      command: npx
      args: ["-y", "@modelcontextprotocol/server-github"]
      env:
        GITHUB_TOKEN: ${GITHUB_TOKEN}

Daemon-Level Configuration

For shared MCP servers across all agents:

# daemon.yaml
mcp_servers:
  - name: postgres
    command: npx
    args: ["-y", "@modelcontextprotocol/server-postgres"]
    env:
      DATABASE_URL: ${DATABASE_URL}

Catalog Overview

Core Servers

Server	Description	Key Tools
Filesystem	Read/write files on the local filesystem	read_file, write_file, list_directory, search_files
Fetch	Make HTTP requests and fetch web content	fetch (GET with auto markdown conversion)
Puppeteer	Browser automation for scraping and testing	navigate, screenshot, click, fill, evaluate

Development

Server	Description	Key Tools
GitHub	GitHub repos, issues, PRs	create_issue, create_pull_request, get_file_contents, search_code
GitLab	GitLab projects, MRs, CI/CD	create_issue, create_merge_request, get_file_contents

Databases

Server	Description	Key Tools
PostgreSQL	Query PostgreSQL databases (read-only)	query
SQLite	Query and modify SQLite databases	read_query, write_query, create_table, list_tables

Communication

Server	Description	Key Tools
Slack	Send messages and interact with Slack	slack_post_message, slack_list_channels, slack_add_reaction

Search

Server	Description	Key Tools
Brave Search	Web search using Brave Search API	brave_web_search, brave_local_search

Installation

All official MCP servers can be installed via npx:

# No installation needed - npx downloads on first use
npx -y @modelcontextprotocol/server-filesystem /path

# Or install globally
npm install -g @modelcontextprotocol/server-filesystem

Security Considerations

1. Credential Management: Use environment variables for secrets
2. Scope Limitation: Restrict filesystem access to specific directories
3. Network Access: Use firewalls to limit puppeteer/fetch targets
4. Audit Logging: AOF logs all MCP tool invocations

Creating Custom MCP Servers

See the MCP Integration Guide for building custom servers.

Next Steps

• Filesystem Server - File operations
• GitHub Server - Repository automation
• PostgreSQL Server - Database queries