#!/usr/bin/env node
/**
* PO Translation MCP Server
* Main entry point
*/
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import {
CallToolRequestSchema,
ListToolsRequestSchema,
Tool
} from '@modelcontextprotocol/sdk/types.js';
import { analyzePoFile, AnalyzePoFileInput } from './tools/analyze.js';
import { validateAndUpdatePoFile, ValidateAndUpdateInput } from './tools/validate-and-update.js';
// Define MCP Tools
const TOOLS: Tool[] = [
{
name: 'analyze_po_file',
description: 'Analyze a .po file and return statistics, untranslated entries, and fuzzy entries',
inputSchema: {
type: 'object',
properties: {
po_file_path: {
type: 'string',
description: 'Absolute path to the .po file (e.g., "/Users/name/project/locale/tr/LC_MESSAGES/django.po")'
},
locale: {
type: 'string',
description: 'Optional locale code (e.g., "tr", "en"). Auto-detected if not provided.'
}
},
required: ['po_file_path']
}
},
{
name: 'validate_and_update_po_file',
description: 'Validate translations AND update PO file in one operation. Validates quality (variables, HTML, URLs, JavaScript) and automatically updates the file if valid. Use force_update=true to update even invalid translations.',
inputSchema: {
type: 'object',
properties: {
po_file_path: {
type: 'string',
description: 'Absolute path to the .po file (e.g., "/Users/name/project/locale/tr/LC_MESSAGES/django.po")'
},
translations: {
type: 'array',
description: 'Array of translation entries to validate and update',
items: {
type: 'object',
properties: {
msgid: {
type: 'string',
description: 'Original text (source language)'
},
msgstr_original: {
type: 'string',
description: 'Original translation (empty string if untranslated)'
},
msgstr_translated: {
type: 'string',
description: 'New translation to validate and apply'
},
line_number: {
type: ['number', 'null'],
description: 'Line number in .po file (optional)'
},
reference: {
type: 'string',
description: 'Source code reference (e.g., "file.html:123")'
},
skipped: {
type: 'boolean',
description: 'Whether this translation was skipped'
},
skip_reason: {
type: ['string', 'null'],
description: 'Reason for skipping (null if not skipped)'
}
},
required: [
'msgid',
'msgstr_original',
'msgstr_translated',
'line_number',
'reference',
'skipped',
'skip_reason'
]
}
},
strict_mode: {
type: 'boolean',
description: 'Treat warnings as errors (default: true)',
default: true
},
check_variables: {
type: 'boolean',
description: 'Check variable preservation (default: true)',
default: true
},
check_html: {
type: 'boolean',
description: 'Check HTML tag preservation (default: true)',
default: true
},
check_urls: {
type: 'boolean',
description: 'Check URL preservation (default: true)',
default: true
},
check_javascript: {
type: 'boolean',
description: 'Check JavaScript code preservation (default: true)',
default: true
},
check_length: {
type: 'boolean',
description: 'Check translation length ratio (default: false)',
default: false
},
dry_run: {
type: 'boolean',
description: 'Preview changes without writing (default: false)',
default: false
},
force_update: {
type: 'boolean',
description: 'Update file even if some translations are invalid (default: false)',
default: false
}
},
required: ['po_file_path', 'translations']
}
}
];
// Create MCP Server
const server = new Server(
{
name: 'po-translation-mcp',
version: '1.0.0'
},
{
capabilities: {
tools: {}
}
}
);
// List Tools Handler
server.setRequestHandler(ListToolsRequestSchema, async () => {
return {
tools: TOOLS
};
});
// Call Tool Handler
server.setRequestHandler(CallToolRequestSchema, async (request) => {
const { name, arguments: args } = request.params;
try {
switch (name) {
case 'analyze_po_file': {
const input = args as unknown as AnalyzePoFileInput;
const result = await analyzePoFile(input);
return {
content: [
{
type: 'text',
text: JSON.stringify(result, null, 2)
}
]
};
}
case 'validate_and_update_po_file': {
const input = args as unknown as ValidateAndUpdateInput;
const result = await validateAndUpdatePoFile(input);
return {
content: [
{
type: 'text',
text: JSON.stringify(result, null, 2)
}
]
};
}
default:
throw new Error(`Unknown tool: ${name}`);
}
} catch (error) {
return {
content: [
{
type: 'text',
text: JSON.stringify(
{
error: error instanceof Error ? error.message : String(error)
},
null,
2
)
}
],
isError: true
};
}
});
// Start Server
async function main() {
const transport = new StdioServerTransport();
await server.connect(transport);
console.error('PO Translation MCP Server running on stdio');
}
main().catch((error) => {
console.error('Server error:', error);
process.exit(1);
});
