gettext-mcp 0.5.0

Model Context Protocol (MCP) server for managing GNU gettext .po/.pot translation files, with CRUD tools and an optional web UI.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

//! CLI subcommand surface for the `gettext-mcp` binary.
//!
//! When the binary is invoked without a subcommand it behaves exactly
//! as before — starting the MCP server over stdio (and optionally the
//! web UI). When a subcommand is given the binary runs that one-shot
//! operation and exits, never starting the MCP server.
//!
//! Each subcommand is a thin shell that calls into the per-tool
//! handlers in [`crate::tools`]; no business logic lives here.

mod add_context;
mod common;
mod completions;
mod coverage;
mod header;
mod info;
mod search;
mod set_fuzzy;
mod stale;
mod validate;

use std::path::PathBuf;
use std::process::ExitCode;

use clap::Subcommand;

pub use header::HeaderCommand;

#[derive(Subcommand, Debug)]
pub enum Command {
    /// Show file summary (path, language, totals).
    Info {
        /// Path to .po/.pot file (auto-discovered if omitted).
        #[arg(long)]
        path: Option<PathBuf>,
    },
    /// Show translation coverage for the file.
    Coverage {
        /// Path to .po/.pot file (auto-discovered if omitted).
        #[arg(long)]
        path: Option<PathBuf>,
    },
    /// Run validation on translations. Exits 2 if errors found.
    Validate {
        /// Path to .po/.pot file (auto-discovered if omitted).
        #[arg(long)]
        path: Option<PathBuf>,
    },
    /// Substring search across msgid + msgstr.
    Search {
        /// Substring pattern.
        pattern: String,
        /// Path to .po/.pot file (auto-discovered if omitted).
        #[arg(long)]
        path: Option<PathBuf>,
        /// Maximum number of results.
        #[arg(long, default_value = "50")]
        limit: usize,
    },
    /// List obsolete (`#~`) entries.
    Stale {
        /// Path to .po/.pot file (auto-discovered if omitted).
        #[arg(long)]
        path: Option<PathBuf>,
    },
    /// Copy an existing entry into a new msgctxt (disambiguation).
    AddContext {
        /// Existing msgid to copy from (uses the no-context variant).
        msgid: String,
        /// New msgctxt to assign on the copy.
        msgctxt: String,
        /// Path to .po/.pot file (auto-discovered if omitted).
        #[arg(long)]
        path: Option<PathBuf>,
        /// Preview without writing.
        #[arg(long)]
        dry_run: bool,
    },
    /// Toggle the fuzzy flag on an entry.
    SetFuzzy {
        /// Target msgid.
        msgid: String,
        /// Optional msgctxt.
        #[arg(long)]
        msgctxt: Option<String>,
        /// Clear the fuzzy flag instead of setting it.
        #[arg(long)]
        clear: bool,
        /// Path to .po/.pot file (auto-discovered if omitted).
        #[arg(long)]
        path: Option<PathBuf>,
        /// Preview without writing.
        #[arg(long)]
        dry_run: bool,
    },
    /// PO header field management (list / get / set).
    #[command(subcommand)]
    Header(HeaderCommand),
    /// Generate shell completion script.
    Completions {
        /// Target shell (bash, zsh, fish, elvish, powershell).
        shell: clap_complete::Shell,
    },
}

pub fn run(cmd: Command, json: bool) -> ExitCode {
    match cmd {
        Command::Info { path } => info::run(path, json),
        Command::Coverage { path } => coverage::run(path, json),
        Command::Validate { path } => validate::run(path, json),
        Command::Search {
            pattern,
            path,
            limit,
        } => search::run(pattern, path, limit, json),
        Command::Stale { path } => stale::run(path, json),
        Command::AddContext {
            msgid,
            msgctxt,
            path,
            dry_run,
        } => add_context::run(msgid, msgctxt, path, dry_run, json),
        Command::SetFuzzy {
            msgid,
            msgctxt,
            clear,
            path,
            dry_run,
        } => set_fuzzy::run(msgid, msgctxt, clear, path, dry_run, json),
        Command::Header(hcmd) => header::run(hcmd, json),
        Command::Completions { shell } => completions::run(shell),
    }
}