Lokalise MCP Server

Lokalise MCP服务器

⚠️ 免责声明：这是一个非官方的个人项目，与Lokalise股份有限公司无关、不认可或不关联。它使用开源 以提供MCP集成。所有的代码和实现都是我自己的工作。

Bring the power of Lokalise to your AI assistant

](https://smithery.ai/server/@AbdallahAHO/lokalise-mcp) ](https://www.npmjs.com/package/lokalise-mcp)   ](https://nodejs.org/)

🎯 这是什么？

Lokalise MCP服务器将Claude等AI助手连接到 Lokalise，领先的翻译管理平台。通过自然对话，您可以管理翻译项目、更新内容和自动化本地化工作流程，无需编码。

非常适合： 产品经理•开发人员•本地化团队•内容团队

______________________________________________________________________

🚀 主要特征和功能

使用以下工具转换您的本地化工作流程 59工具 横跨 11个域名 和 17个预构建的自动化模板:

🎯 为什么要使用Lokalise MCP？

✨ 在行动中看到它

复制这些提示，体验复杂的多工具编排。从简单的请求到高级模式，Claude会自动处理复杂性：

💻 React i18n开发工作流（Cursor IDE）

*MCP工具： lokalise_list_projects → lokalise_list_keys → lokalise_create_keys → lokalise_list_usergroups → lokalise_create_task*

Prompt: "I'm working on a new checkout flow in React. Please scan my current
components, extract all hardcoded strings that need internationalization,
convert them to i18n keys using our naming convention (checkout.step1.title),
refactor the JSX to use our i18next hooks, then sync the new keys to our
'Mobile App' project in Lokalise and create translation tasks for our EU markets using relevant tools in configured Lokalise MCP.

Use these exact Lokalise MCP tools:
- lokalise_list_projects (to find Mobile App project)
- lokalise_list_keys (to check for existing keys)
- lokalise_create_keys (to upload new i18n keys)
- lokalise_list_usergroups (to find EU translation teams)
- lokalise_create_task (to create translation tasks)"

// Before: components/checkout/PaymentStep.tsx
const PaymentStep = () => (
  

    
Payment Information

    
Enter your card details below

    Continue to Review
  

);

What Claude orchestrates with MCP tools:
✓ `lokalise_list_projects` - Locates 'Mobile App' project
✓ `lokalise_list_keys` - Validates against existing keys to prevent duplicates
✓ `lokalise_create_keys` - Bulk uploads new i18n keys with platform tags:
  [{
    key_name: "checkout.payment.title",
    platforms: ["web", "ios", "android"],
    translations: [{ language_iso: "en", translation: "Payment Information" }]
  }]
✓ `lokalise_list_usergroups` - Resolves "EU markets" to specific translation teams
✓ `lokalise_create_task` - Creates translation tasks for DE, FR, ES, IT with team assignments
✓ Auto-refactors JSX to use useTranslation hooks
✓ Updates local i18n JSON files with new key structure

// After: Automatically refactored
const PaymentStep = () => {
  const { t } = useTranslation();
  return (
    

      
{t('checkout.payment.title')}

      
{t('checkout.payment.subtitle')}

      {t('checkout.payment.continue')}
    

  );
};

Result: Code internationalized, 12 new keys synced via Lokalise MCP tools,
translation tasks created for 4 languages—all without leaving your IDE.
Development workflow stays uninterrupted while localization setup happens
automatically through direct lokalise MCP integration.

📊 CSV翻译上传自动化

*触发器： lokalise_list_projects → CSV解析→ lokalise_create_keys （散装）→ lokalise_list_project_languages → lokalise_create_task （每种语言）*

Prompt: "I'm attaching our latest feature strings export from Product. It's a CSV with
columns: key_id, context, en_source, es_draft, fr_draft. Using relevant tools in configured Lokalise MCP; Please upload these 50 new keys to our 'E-commerce Platform' project, create translation tasks for the missing
languages (German, Italian, Portuguese), and assign them to our relevant regional teams.
The Product team wants this shipped by end of sprint (March 15th)."

[Attach: feature_v3_strings.csv]

What Claude orchestrates:
✓ Parses CSV and validates column structure
✓ Locates E-commerce Platform project
✓ Creates 50 keys with English source + Spanish/French drafts
✓ Identifies missing target languages (DE, IT, PT)
✓ Resolves regional team assignments automatically
✓ Creates separate translation tasks per language/team
✓ Sets March 15th deadline with buffer for review
✓ Provides upload summary + task tracking URLs

Result: 50 keys uploaded, 3 translation tasks created, teams notified—
what used to take 2 hours of manual CSV imports, key creation, and task setup
now happens in 30 seconds with full audit trail and team coordination.

🎯 战略投资组合仪表板

*触发器： lokalise_list_projects → lokalise_get_project （平行）→ lokalise_list_project_languages → lokalise_list_tasks*

Prompt: "I need a strategic overview of my localization portfolio. Using relevant tools in configured Lokalise MCP;
Show me which projects need immediate attention, identify bottlenecks across teams, and give me data-driven
recommendations for resource allocation. Include completion rates, task backlogs, and
any projects that haven't seen activity in the last 30 days."

What Claude does automatically:
✓ Fetches all projects with statistics
✓ Analyzes each project's health in parallel
✓ Cross-references team workloads
✓ Identifies stalled projects and overdue tasks
✓ Generates strategic recommendations

Result: Executive-level insights you can act on immediately

🔄 智能文件处理工作流

*触发器： lokalise_list_projects → lokalise_list_keys （按文件名筛选）→ lokalise_list_usergroups + lokalise_list_contributors → lokalise_list_project_languages → lokalise_create_task （多个）*

Prompt: "I just uploaded 'user-onboarding-v2.json' to my Mobile App project via the Lokalise UI.
The TM+MT processing is done. Now create review tasks for quality assurance - assign
Spanish content to our EMEA translation team, French to Marie (marie@ourcompany.com),
and German to whoever is available on the DACH team. Set the deadline for next Friday."

What Claude orchestrates:
✓ Locates your Mobile App project
✓ Finds all keys from the uploaded file
✓ Resolves "EMEA translation team" → user group ID
✓ Resolves "marie@ourcompany.com" → contributor ID
✓ Finds DACH team members and assigns optimally
✓ Creates separate review tasks per language
✓ Sets appropriate deadlines and task descriptions

Result: Complete review workflow ready in seconds, not minutes of manual setup

🚀 智能验证的批量操作

*触发器： lokalise_list_projects → lokalise_list_keys （已过滤）→ lokalise_bulk_update_keys → lokalise_list_tasks → lokalise_create_task*

Prompt: "I need to clean up our iOS release. Find all keys tagged 'onboarding' across all
projects, ensure they have iOS platform designation, verify they're all translated to
Spanish and French, and create catch-up tasks for any missing translations. Also check
if any of these keys have been changed in the last 7 days and might need re-review."

What Claude coordinates:
✓ Searches across all projects for 'onboarding' tagged keys
✓ Audits platform tags and adds iOS where missing
✓ Cross-checks translation completeness for Spanish/French
✓ Identifies recently modified keys needing re-review
✓ Creates targeted tasks for missing translations
✓ Provides summary of changes and remaining work

Result: Release-ready content with full audit trail and completion plan

💡 大师提示：您提供的上下文和约束越多，Claude的编排就越聪明。包括时间表、优先级、团队约束和业务目标，以最大限度地利用人工智能。

______________________________________________________________________

🎯 内置工作流提示

除了这些示例，MCP服务器还包括 17个复杂的提示模板 自动编排复杂的多工具工作流。这些不仅仅是示例，它们是您可以立即使用的生产就绪模板。

📋 项目管理套件

战略项目监督的现成提示：

🌍 本地化工作流套件

自动语言扩展和进度监控：

🔄 高级工作流自动化

复杂的多阶段编排：

🚀 企业自动化套件

用于复杂操作的生产就绪工作流：

🎭 如何使用提示模板

# In Claude, simply reference the prompt name:
"Use the project_portfolio_overview prompt from configured Lokalise MCP to analyze my localization portfolio"

# Or trigger directly with parameters:
"Run the post_upload_review_workflow from configured Lokalise MCP  for 'user-guide.pdf' in Mobile App project,
assign Spanish to EMEA Team and French to marie@company.com"

# Customize for your needs:
"Use the team_translation_setup prompt from configured Lokalise MCP but focus on timezone optimization
for our distributed team across 4 continents"

模板优势：

• 🎯 零学习曲线：预构建的工作流程随时可用
• 🚀 多工具编排：每个模板自动协调3-10个工具
• 🧠 情境感知：智能参数解析和错误处理
• 📊 丰富的输出：具有可操作见解的格式化报告
• ⚡ 生产就绪：在真实的本地化项目中进行了实战测试

______________________________________________________________________

📦 快速开始

在60秒内起床并跑步：

🚀 推荐：一键安装

](https://smithery.ai/server/@AbdallahAHO/lokalise-mcp)

# Install for Claude Desktop (most popular)
npx -y @smithery/cli install @AbdallahAHO/lokalise-mcp --client claude

# Other clients: cursor, vscode, raycast, gemini

发生了什么： 自动插入，配置权限，提示您的Lokalise API密钥，随时可用。

🎯 替代安装方法

Claude Desktop Extension (.dxt)

快速本地安装，无需Node.js：

1. 下载最新 .dxt 从 发布
2. 双击或拖动到Claude Desktop→ 设置→ 扩展
3. 输入您的 LOKALISE_API_KEY 当系统提示时
4. 验证：“你能列出我的Lokalise项目吗？”

NPX (No Installation)

无需安装即可直接运行：

# Direct execution
npx lokalise-mcp

Claude桌面配置 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "lokalise": {
      "command": "npx",
      "args": ["-y", "lokalise-mcp"],
      "env": {"LOKALISE_API_KEY": "your-api-key-here"}
    }
  }
}

Global Install

npm install -g lokalise-mcp
lokalise-mcp  # Run the server

🔑 获取API密钥

1. 登录到 Lokalise
2. 首选 个人资料 → API令牌 (https://app.lokalise.com/profile#apitokens)
3. 点击 生成新令牌
4. 安全复制和保存

⚙️ 配置

API密钥设置

Lokalise API密钥可以通过多种方式配置（按优先级顺序）：

1. 环境变量 （出于安全考虑，建议使用）：

   export LOKALISE_API_KEY="your-api-key-here"

1. .env 文件 （当地发展）：

   cp .env.example .env
   # Edit .env and add your API key

1. 全局MCP配置 (~/.mcp/configs.json):

   {
     "lokalise-mcp": {
       "LOKALISE_API_KEY": "your-api-key-here"
     }
   }

获取您的API代币

1. 登录到 Lokalise
2. 引导到 个人资料 → API令牌 (https://app.lokalise.com/profile#apitokens)
3. 点击 生成新令牌
4. 复制令牌并安全保存

🚀 运行服务器

# HTTP mode (recommended for development)
npm run mcp:http

# STDIO mode (for Claude Desktop integration)
npm run mcp:stdio

# CLI mode (direct commands)
npm run cli -- list-projects

🤖 与Claude Desktop一起使用

快速验证

安装后，您可以通过询问Claude来验证连接：

“你能列出我的Lokalise项目吗？”

克劳德将使用 lokalise_list_projects 用于获取和显示项目的工具。

Claude桌面设置

如果通过Smithery安装，则不需要手动配置。通过查找来验证🔌 图标并问克劳德：“你能列出我的Lokalise项目吗？”

✅ 验证

安装后，测试连接：

"Can you list my Lokalise projects?"

克劳德将使用 lokalise_list_projects 工具，并用统计数据显示您的项目。

📚 可用工具

服务器提供 59个MCP工具 涵盖Lokalise的所有主要业务 11个域名:

Click to see all available tools

项目（6个工具）

• lokalise_list_projects -列出所有具有统计信息的项目
• lokalise_get_project -获取详细的项目信息
• lokalise_create_project -创建新项目
• lokalise_update_project -更新项目设置
• lokalise_delete_project -删除项目
• lokalise_empty_project -从项目中删除所有密钥

钥匙（7个工具）- 通过文件过滤增强

• lokalise_list_keys -列出密钥 新建: filterFilenames 支持
• lokalise_get_key -获取详细的关键信息
• lokalise_create_keys -一次创建多个密钥（最多1000个）
• lokalise_update_key -更新单个密钥
• lokalise_bulk_update_keys -更新多个密钥
• lokalise_delete_key -删除单个密钥
• lokalise_bulk_delete_keys -删除多个密钥

语言（6工具）

• lokalise_list_system_languages -列出所有可用语言
• lokalise_list_project_languages -列出项目语言
• lokalise_add_project_languages -向项目添加语言
• lokalise_get_language -获取语言详细信息
• lokalise_update_language -更新语言设置
• lokalise_remove_language -删除语言

用户组（8个工具）- 新

• lokalise_list_usergroups -列出所有用户组
• lokalise_get_usergroup -获取组详细信息
• lokalise_create_usergroup -创建新组
• lokalise_update_usergroup -更新组设置
• lokalise_delete_usergroup -删除组
• lokalise_add_members_to_group -将成员添加到组
• lokalise_remove_members_from_group -从组中删除成员
• lokalise_add_projects_to_group -将项目分配给组

翻译（4个工具）

• lokalise_list_translations -带光标分页的列表
• lokalise_get_translation -获取翻译详细信息
• lokalise_update_translation -更新翻译
• lokalise_bulk_update_translations -具有速率限制的批量更新

其他收藏

• 贡献者 （6个工具）-管理项目团队成员
• 任务 （5个工具）-创建和管理翻译任务
• 评论 （5个工具）-处理关键意见和讨论
• 术语表 （5个工具）-保持术语的一致性
• 团队用户 （4个工具）- 新 -工作区用户管理
• 排队进程 （2个工具）- 新 -监控后台操作

🛠️ 高级配置

环境变量

🐛 故障排除

“身份验证失败”

• 验证您的API令牌是否正确
• 检查Lokalise设置中的令牌权限
• 确保令牌具有适当的项目访问权限

“超出费率限制”

• 服务器包括自动速率限制
• 对于大容量操作，考虑批处理
• 等待60秒后重试

“连接被拒绝”

• 对于HTTP模式：确保服务器正在运行(npm run mcp:http)
• 对于STDIO模式：检查Claude Desktop配置
• 验证端口3000的防火墙设置

配置文件位置

Claude桌面配置：

• 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

MCP全局配置：

• 所有平台： ~/.mcp/configs.json

调试模式

启用详细日志记录：

# For development
DEBUG=true npm run mcp:http

# In Claude Desktop config
"env": {
  "LOKALISE_API_KEY": "your-key",
  "DEBUG": "true"
}

获取帮助

1. 检查此故障排除部分
2. 审查
3. 启用调试模式以查看详细的错误消息
4. 使用调试日志联系支持人员

📄 许可证

MIT许可证-请参阅 许可证 了解详情。

🤝 贡献

我们欢迎捐款！查看我们的 贡献指南 有关以下内容的详细信息：

• 建立开发环境
• 架构和代码组织
• 对所有PR进行自动化CI/CD检查
• 发布流程和工作流程
• 创建新的工具和域
• 提交拉取请求

🙏 致谢

• 建立在 模型上下文协议 通过Anthropic
• 使用开源

______________________________________________________________________

⭐ Star us on GitHub • Report an Issue • Learn about Lokalise