Skip to main content
Glama
mcp-apollo-config

mcp-apollo-config

by xsg22

mcp-apollo-config

MCP server for Apollo Config Center using portal username/password login, implemented with FastMCP.

Install

pip install mcp-apollo-config

Local editable install:

pip install -e .

Related MCP server: mcp-nacos

Auth Mode

The plugin authenticates by portal session:

  1. POST /signin with username/password

  2. Receives login session cookie (SESSION or JSESSIONID)

  3. Uses portal management APIs under /apps/{appId}/envs/{env}/...

No OpenAPI token is required.

Governance Mode

  • readonly (default): query only

  • editable: query + edit (requires --operator)

MCP Configuration

Configure the server in your MCP client with command + args:

{
  "mcpServers": {
    "apollo": {
      "command": "mcp-apollo-config",
      "args": [
        "--portal-url", "http://apollo-portal.example.com",
        "--username", "your.username",
        "--password", "your.password",
        "--governance-mode", "readonly",
        "--default-app-id", "your-app-id",
        "--default-env", "DEV",
        "--default-cluster", "default",
        "--default-namespace", "application"
      ]
    }
  }
}

Full Parameters

Required:

  • --portal-url or APOLLO_PORTAL_URL

  • --username or APOLLO_USERNAME

  • --password or APOLLO_PASSWORD

Optional:

  • --login-submit or APOLLO_LOGIN_SUBMIT

  • --governance-mode or APOLLO_GOVERNANCE_MODE: readonly|editable

  • --operator or APOLLO_OPERATOR (required in editable mode)

  • --default-app-id or APOLLO_DEFAULT_APP_ID

  • --default-env or APOLLO_DEFAULT_ENV (for example DEV, TEST)

  • --default-cluster or APOLLO_DEFAULT_CLUSTER (default: default)

  • --default-namespace or APOLLO_DEFAULT_NAMESPACE

  • --timeout-ms or APOLLO_TIMEOUT_MS (default: 10000)

  • --log-level or MCP_APOLLO_LOG_LEVEL: DEBUG|INFO|WARN|ERROR (default: WARN)

  • --debug-http or MCP_APOLLO_DEBUG_HTTP=true

Tools

  • apollo_get_namespace_configs: query all key/value items under a namespace/environment/cluster with pagination controls (pageSize, maxItems).

  • apollo_get_key: query one config key under a namespace/environment/cluster.

  • apollo_edit_key (editable mode only): create or update one key and return the updated item.

Tests

Local tests use a mock Apollo portal server and do not require real credentials or network access.

python -m unittest discover -s tests -p "test_*.py"

Covered scenarios:

  • tools/list in readonly and editable mode

  • apollo_get_key

  • apollo_get_namespace_configs

  • apollo_edit_key

  • Portal session login + cookie flow

Notes

  • The management API path includes /envs/{env}. Set --default-env or pass env in tool arguments.

  • The server is built on FastMCP and runs in stdio transport mode.

  • After editing a key, Apollo release may still be needed before clients see the change.

  • Avoid keeping DEBUG logs enabled in production for long periods.

Chinese README

Available Tools

2 tools
apollo_get_keyC

Query a single key in a namespace/environment/cluster in Apollo.

Inputs: key (required), appId, env, clusterName, +1 more. Returns: result

apollo_get_namespace_configsC

Query all configs under a namespace/environment/cluster in Apollo.

Inputs: appId, env, clusterName, namespaceName, +2 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one retrieves a single key, the other retrieves all configs under a namespace. No overlap in functionality.

    Naming Consistency5/5

    Both tools follow a consistent 'apollo_get_<thing>' pattern in snake_case, making it predictable and easy to understand.

    Tool Count4/5

    With only 2 tools, the surface is thin but appropriate for a read-only query interface focused on single key and full namespace config retrieval.

    Completeness2/5

    The server lacks any write operations (create, update, delete) and only provides basic read capabilities. Significant gaps exist for managing configurations.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • AppFolio MCP server for ChatGPT, Claude and any AI agent: create work order, assign work order, schedule work order, list open work orders, get tenant ledger and run report in your own AppFolio account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to AppFolio yourself; Cotlet does not store your password and you need no AppFolio API key. About the official AppFolio API: Partly. AppFolio announced a Realm-X connector for Claude on 9 Jun 2026, which hands a job to Realm-X inside AppFolio, and its pricing page lists an AppFolio API on the Plus (read only) and Max (read/write) plans (checked 6 Nov 2026). Setup and FAQ: https://cotlet.dev/integrations/appfolio-api-mcp-server

    • AppFlowy MCP server for ChatGPT, Claude and any AI agent: list workspaces, read page tree, list database rows, create database row, update database row, create page, restore from trash and share page in your own AppFlowy account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to AppFlowy yourself; Cotlet does not store your password and you need no AppFlowy API key. About the official AppFlowy API: AppFlowy Cloud has a documented REST API for workspaces, the folder tree and database rows, but no hosted MCP server (checked 25 Oct 2026). The official MCP service is an optional part of the commercial self-hosted edition. Setup and FAQ: https://cotlet.dev/integrations/appflowy-api-mcp-server

    • VaultRE MCP server for ChatGPT, Claude and any AI agent: list enquiries, process enquiry, search contacts, add contact, add note, search properties, add appraisal and schedule viewing in your own VaultRE account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to VaultRE yourself; Cotlet does not store your password and you need no VaultRE API key. About the official VaultRE API: Yes, but only for approved integrators (checked 22 Oct 2026). VaultRE, now MRI Vault, publishes API docs, yet a developer needs an integrator key from MRI first, and the agency then creates an access token for that developer under Office Integrations > Third-Party Access. Setup and FAQ: https://cotlet.dev/integrations/vaultre-api-mcp-server

      https://cotlet.dev/mcp/v1/vaultre
    • Clio MCP server for ChatGPT, Claude and any AI agent: search matters, log time entry, create task, add matter note, create calendar entry and list bills in your own Clio account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Clio yourself; Cotlet does not store your password and you need no Clio API key. About the official Clio API: Yes. Clio has a REST API, the Clio Manage API v4, with OAuth 2.0 (checked 6 Nov 2026). Setup and FAQ: https://cotlet.dev/integrations/clio-api-mcp-server

      https://cotlet.dev/mcp/v1/clio

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables large language models to query and operate on Apollo Configuration Center. Supports managing apps, clusters, namespaces, config items, and releases.
      17
      24 PyPI
      3
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to query and manage Nacos configurations, supporting Nacos 1.x/2.x/3.x with multiple transport protocols.
      7
      1
      MIT
    • F
      license
      B
      quality
      B
      maintenance
      Enables querying logs across Loki/SLS, querying databases via Archery, accessing Choerodon project collaboration tools, and searching local code repositories through a unified MCP interface with self-contained configuration.
      17
      2
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI clients to read Nacos configuration center data via read-only MCP tools, including namespaces, config search, details, and history across Nacos 1.x, 2.x, and 3.x.
      6
      MIT