BIPO i18n MCP Server

A Model Context Protocol (MCP) server for managing i18n keys on BIPO Axis platform.

Features

• Query i18n keys: Search for existing i18n entries by text (exact or fuzzy match)
• Create i18n entries: Create new i18n entries with system type support
• Delete i18n entries: Remove i18n entries by key
• Batch operations: Search/create multiple entries at once
• Auto token refresh: Automatically refresh token before expiration using refreshToken

Installation

Using npx (Recommended)

No installation needed! Just configure your MCP client:

{
  "mcpServers": {
    "bipo-i18n": {
      "command": "npx",
      "args": ["-y", "bipo-i18n-mcp"]
    }
  }
}

Manual Installation

npm install -g bipo-i18n-mcp

Then configure:

{
  "mcpServers": {
    "bipo-i18n": {
      "command": "bipo-i18n-mcp"
    }
  }
}

Tools

i18n_search

Search for i18n entries by text content.

Parameters:

• query (required): Search text (English or Chinese)
• exact (optional): Use exact match (default: false)
• systemType (optional): Filter by system. Use comma-separated for multiple: 'Butter,Shared'. Default: 'Butter,Shared'. Use 'all' to search all systems.
• page (optional): Page number (default: 1)
• size (optional): Results per page (default: 30)

i18n_create

Create a new i18n entry.

Parameters:

• en (required): English text
• zh (required): Chinese (Simplified) text
• system (optional): System type (default: "Butter")
• code (optional): Custom code/key (auto-generated if empty)
• feature (optional): Feature identifier

i18n_delete

Delete an i18n entry by key.

Parameters:

• key (required): The i18n key to delete (e.g., 'XXUFI1')

i18n_batch

Batch search/create multiple texts at once.

Parameters:

• texts (required): Array of objects with en and optionally zh
• createMissing (optional): Auto-create missing entries (default: false)
• system (optional): System type for created entries (default: "Butter")

i18n_set_token

Set authentication tokens for BIPO Axis.

Parameters:

• accessToken: Access token from localStorage
• refreshToken: Refresh token for auto-refresh capability
• expiredAt: Token expiration timestamp (milliseconds)
• token: Legacy single token support

i18n_check_auth

Check if authentication token is configured and valid.

i18n_open_login

Open the BIPO Axis login page in browser.

i18n_open_helper

Open the Token Helper page with instructions.

Token Management

Auto Refresh

When you provide both accessToken and refreshToken, the server will automatically refresh the token 5 minutes before expiration. No manual intervention needed!

Setting Token with Auto-Refresh

Get token data from browser localStorage and set it:

i18n_set_token accessToken="eyJ..." refreshToken="eyJ..." expiredAt=1767621585536

Getting Token from Browser

1. Open https://axis.bipocloud.com and login
2. Open DevTools (F12) -> Application tab -> Local Storage
3. Find and copy: accessToken, refreshToken, expiredAt
4. Use i18n_set_token with all three values

Legacy Token (No Auto-Refresh)

You can still use a simple token from network requests:

1. Open DevTools (F12) -> Network tab
2. Refresh the page
3. Click any request, find x-dk-token header
4. Use i18n_set_token token="eyJ..."

System Types

| UI Name | API Code | |---------|----------| | Butter | Archegos | | Wise | Wise | | Docs | Docs | | Axis | Axis | | Workio | Workio | | Shared | Shared | | Spell | Spell | | ClientBase | ClientBase |

Token Storage

Token is stored at: ~/.bipo-i18n-mcp/token.json

{
  "accessToken": "eyJ...",
  "refreshToken": "eyJ...",
  "expiredAt": 1767621585536,
  "savedAt": "2026-01-02T08:55:07.000Z"
}

License

MIT