newt-mcp-server 0.8.3

Newt-Agent stdio MCP server — code.read / code.edit / code.search / goal.run
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

"""Newt-MCP-Server — stdio MCP server for newt-agent.

This package is a thin Python wrapper around the ``newt-mcp-server``
binary that maturin ships in the wheel. The binary lives next to this
module after installation (maturin places ``bin/newt-mcp-server`` in the
wheel's data scripts dir).

Usage:
    >>> import newt_mcp_server
    >>> newt_mcp_server.main()      # runs the MCP server (stdio JSON-RPC)

Or from the shell:
    $ newt-mcp-server
    $ python -m newt_mcp_server     # equivalent

The MCP server speaks JSON-RPC over stdio. It is intended to be spawned
by an MCP host (e.g. Claude Code, claude.ai) rather than run interactively.
"""

from __future__ import annotations

import os
import sys
from typing import NoReturn

__all__ = ["main", "binary_path"]


def binary_path() -> str:
    """Return the absolute path to the bundled ``newt-mcp-server`` binary."""
    import shutil

    found = shutil.which("newt-mcp-server")
    if found is None:
        raise RuntimeError(
            "newt-mcp-server binary not found on PATH. "
            "Did `pip install newt-mcp-server` complete successfully?"
        )
    return found


def main(argv: list[str] | None = None) -> NoReturn:
    """Exec the ``newt-mcp-server`` binary, replacing the current process."""
    if argv is None:
        argv = sys.argv[1:]
    os.execvp("newt-mcp-server", ["newt-mcp-server", *argv])


if __name__ == "__main__":
    main()