FFS MCP Server

MCP (Model Context Protocol) Server for managing FFS (Feature Flag Service).

Features

• 🔐 ffs_get_user_info: Get AccountId and ExtensionId from RingCentral credentials
• 🔍 ffs_search_flag: Search for FFS flags by keyword
• 📋 ffs_get_flag_options: Get all available options for a Flag
• ✅ ffs_check_account: Check account status in a Flag
• ✏️ ffs_update_account: Update account's Flag value

Configuration

The server requires the following environment variables:

| Variable | Description | Required | |----------|-------------|----------| | FFS_BASE_URL | FFS API base URL | ✅ | | FFS_RC_API_URL | RingCentral API URL | ✅ | | FFS_RC_CLIENT_CREDENTIALS | Base64 encoded client credentials | ✅ |

Usage with npx (Recommended)

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ffs": {
      "command": "npx",
      "args": ["@xcodeyang/ffs-mcp-server"],
      "env": {
        "FFS_BASE_URL": "http://your-ffs-server:8080",
        "FFS_RC_API_URL": "https://your-rc-api-server",
        "FFS_RC_CLIENT_CREDENTIALS": "your-base64-credentials"
      }
    }
  }
}

Augment (VS Code)

{
  "augment.advanced": {
    "mcpServers": [
      {
        "name": "ffs",
        "command": "npx",
        "args": ["@xcodeyang/ffs-mcp-server"],
        "env": {
          "FFS_BASE_URL": "http://your-ffs-server:8080",
          "FFS_RC_API_URL": "https://your-rc-api-server",
          "FFS_RC_CLIENT_CREDENTIALS": "your-base64-credentials"
        }
      }
    ]
  }
}

Publishing

# Build first
npm run build

# Publish to RingCentral Nexus registry
npm publish

Tools

ffs_get_user_info

Get AccountId and ExtensionId from RingCentral credentials.

Input:

• username: RingCentral user email
• password: RingCentral password

Output:

• accountId: Company-level ID (affects all users in the company)
• extensionId: User-level ID (affects only this user)

ffs_search_flag

Search for FFS flags by keyword.

Input:

• keyword: Search keyword or complete Flag ID

ffs_get_flag_options

Get all available options for a Flag.

Input:

• flagId: Complete FFS Flag ID

Output:

• List of options with valueId (needed for updates)

ffs_check_account

Check account status in a Flag.

Input:

• flagId: Complete FFS Flag ID
• id: AccountId or ExtensionId

ffs_update_account

Update account's Flag value using MCP Auto Condition.

Input:

• flagId: Complete FFS Flag ID
• id: AccountId or ExtensionId
• targetValueId: Value ID from ffs_get_flag_options

Development

# Run in development mode
npm run dev

# Build
npm run build

# Test tools
npx tsx test-tools.ts