https://github.com/simplelocalize/simplelocalize-mcp-server
Interact with the SimpleLocalize API using AI assistants like Github Copilot, Claude, or in AI-powered IDEs like Cursor AI.
https://github.com/simplelocalize/simplelocalize-mcp-server
cursor-ai i18n llm mcp mcp-server modelcontextprotocol typescript
Last synced: 4 months ago
JSON representation
Interact with the SimpleLocalize API using AI assistants like Github Copilot, Claude, or in AI-powered IDEs like Cursor AI.
- Host: GitHub
- URL: https://github.com/simplelocalize/simplelocalize-mcp-server
- Owner: simplelocalize
- License: apache-2.0
- Created: 2025-06-03T07:48:49.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-06-03T13:19:27.000Z (5 months ago)
- Last Synced: 2025-07-09T15:04:28.491Z (4 months ago)
- Topics: cursor-ai, i18n, llm, mcp, mcp-server, modelcontextprotocol, typescript
- Language: TypeScript
- Homepage: https://simplelocalize.io
- Size: 60.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **simplelocalize-mcp-server** - Interact with the SimpleLocalize API using AI assistants like Github Copilot, Claude, or in AI-powered IDEs like Cursor AI. `typescript` `cursor-ai` `i18n` `llm` `mcp` `npm install simplelocalize/simplelocalize-mcp-server` (🤖 AI/ML)
- awesome-mcp-servers - **simplelocalize-mcp-server** - Interact with the SimpleLocalize API using AI assistants like Github Copilot, Claude, or in AI-powered IDEs like Cursor AI. `typescript` `cursor-ai` `i18n` `llm` `mcp` `npm install simplelocalize/simplelocalize-mcp-server` (AI/ML)
README
# MCP Server for SimpleLocalize
[SimpleLocalize](https://www.simplelocalize.io/?utm_source=dx&utm_medium=simplelocalize-mcp-server) is the developer-first translation management system.
This is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server that provides tools for interacting with the SimpleLocalize API.
## Features (Tools)
- Create translation key
- Update translations
- Get all translation keys
- Get translation key details
- Get tags
- Create tag
- Get languages
- Create languages
- Get translations
Feel free to add more tools by making a pull request or [creating a feature request](https://github.com/simplelocalize/simplelocalize-mcp-server/issues/new).
## Installation
To use the MCP server, you'll need an API key. You can create and manage API keys in **SimpleLocalize > Settings > Credentials**:
To run the server in a client like Claude Desktop, Cursor or Windsurf, add the following to your MCP config:
```json
{
"mcpServers": {
"simplelocalize": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@simplelocalize/simplelocalize-mcp", "--api-key=SIMPLELOCALIZE_API_KEY"]
}
}
}
```
Replace `SIMPLELOCALIZE_API_KEY` with your API key
For detailed setup guides, see:
- [Cursor AI](https://docs.cursor.com/context/model-context-protocol)
- [Visual Studio Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)
- [GitHub Copilot](https://github.blog/changelog/2025-05-19-agent-mode-and-mcp-support-for-copilot-in-jetbrains-eclipse-and-xcode-now-in-public-preview/)
- [Claude Desktop](https://modelcontextprotocol.io/quickstart/user)
- [Windsurf](https://docs.codeium.com/windsurf/mcp)
## Development
1. Install dependencies:
```bash
pnpm install
```
2. Build the server:
```bash
pnpm build
```
3. Update client to use the local build:
```json
{
"mcpServers": {
"simplelocalize": {
"command": "node",
"args": ["path/to/simplelocalize-mcp-server/build/index.js"],
"env": {
"SIMPLELOCALIZE_API_KEY": "your_api_key",
}
}
}
}
```
## Debugging
To debug the MCP server, you can use the MCP Inspector tool:
1. Run the server with the inspector:
```bash
pnpm inspector
```
2. Open the provided URL in your browser to view and debug the MCP requests and responses.
3. Include the `--api-key` argument.
## Learn more
- [SimpleLocalize developer docs](https://simplelocalize.io/docs/?utm_source=dx&utm_medium=simplelocalize-mcp-server)
- [SimpleLocalize API reference](https://simplelocalize.io/docs/api/get-started/?utm_source=dx&utm_medium=simplelocalize-mcp-server)
- [Sign up for SimpleLocalize](https://simplelocalize.io/register/?utm_source=dx&utm_medium=simplelocalize-mcp-server)