# 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`:

```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)

```json
{
  "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

```bash
# 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

```bash
# Run in development mode
npm run dev

# Build
npm run build

# Test tools
npx tsx test-tools.ts
```