zai-coding-gateway 0.1.0__tar.gz → 0.1.1__tar.gz

{zai_coding_gateway-0.1.0 → zai_coding_gateway-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zai-coding-gateway
-Version: 0.1.0
+Version: 0.1.1
 Summary: MCP-сервер для решения задач в рабочем пространстве через Z.AI Coding Plan (solve_in_workspace, apply_changes)
 License: MIT
 Classifier: License :: OSI Approved :: MIT License
@@ -59,27 +59,39 @@ MCP запускается вашей IDE при открытии проекта
 
 ## Подключение в Cursor
 
-1. Скопируйте пример конфигурации:
+### Вариант: пакет с PyPI (как shadcn — только конфиг)
+
+Установка не нужна: Cursor при старте вызовет `pipx run zai-coding-gateway`, пакет подтянется с PyPI. Но Cursor не видит PATH из терминала, поэтому в `command` нужен **полный путь к pipx**.
+
+1. Установите pipx, если ещё нет: [pypa.github.io/pipx](https://pypa.github.io/pipx/) (`brew install pipx` на macOS, `pip install pipx` и т.п.).
+2. Запустите скрипт — он найдёт pipx на вашей платформе и выведет готовый фрагмент для `mcp.json`:
    ```bash
-   cp mcp.json.example mcp.json
+   python scripts/print_mcp_config.py
    ```
-2. Откройте `mcp.json` и в секции `env` подставьте свой `ZAI_API_KEY`.
-3. Добавьте содержимое `mcp.json` в настройки MCP Cursor (например, в `~/.cursor/mcp.json` или в настройках проекта в разделе MCP Servers). **При использовании в другом проекте** укажите в `env` путь к корню этого проекта: `"ZAI_PROJECT_ROOT": "/путь/к/проекту"` (Cursor пока не передаёт workspace через MCP roots/list). Формат:
+   Или из репозитория пакета (после клонирования): `python scripts/print_mcp_config.py`.
+3. Скопируйте вывод и вставьте в `~/.cursor/mcp.json` в объект `mcpServers` (если файла нет — создайте с обёрткой `{"mcpServers": { ... } }`).
+4. Вставьте в `env` свой `ZAI_API_KEY` и при необходимости `ZAI_PROJECT_ROOT`.
+5. Перезапустите MCP в Cursor (или перезапустите Cursor).
+
+Скрипт `print_mcp_config.py` поддерживает macOS, Linux и Windows и подставляет типичные пути к pipx. Если репозитория нет (только пакет с PyPI), подставьте путь к pipx вручную — типичные расположения:
+
+| Платформа | Типичный путь к pipx |
+|-----------|----------------------|
+| macOS (Homebrew) | `/opt/homebrew/bin/pipx` или `/usr/local/bin/pipx` |
+| Linux | `$HOME/.local/bin/pipx` или `/usr/bin/pipx` |
+| Windows | `%USERPROFILE%\.local\bin\pipx.exe` или через `where pipx` в cmd |
+
+В терминале: `which pipx` (macOS/Linux) или `where pipx` (Windows) — выведет путь для вашей системы.
+
+### Вариант: локальная разработка (pip install -e .)
+
+1. В проекте: `pip install -e .`
+2. В `mcp.json` укажите полный путь к тому же Python, в окружении которого установлен пакет, например:
    ```json
-   {
-     "mcpServers": {
-       "zai-coding-gateway": {
-         "command": "/путь/к/.venv/bin/python",
-         "args": ["-m", "zai_coding_gateway.main", "--stdio"],
-         "env": {
-           "ZAI_API_KEY": "ваш-ключ",
-           "ZAI_PROJECT_ROOT": "/путь/к/корню/проекта"
-         }
-       }
-     }
-   }
+   "command": "/путь/к/.venv/bin/python",
+   "args": ["-m", "zai_coding_gateway.main", "--stdio"],
    ```
-4. Убедитесь, что в PATH доступен тот же Python, в окружении которого установлен пакет (`pip install -e .`). Либо укажите полный путь к `python` в `command`.
+3. В `env` задайте `ZAI_API_KEY` и при необходимости `ZAI_PROJECT_ROOT`.
 
 ## Модели (work / fast)
 

{zai_coding_gateway-0.1.0 → zai_coding_gateway-0.1.1}/README.md

@@ -39,27 +39,39 @@ MCP запускается вашей IDE при открытии проекта
 
 ## Подключение в Cursor
 
-1. Скопируйте пример конфигурации:
+### Вариант: пакет с PyPI (как shadcn — только конфиг)
+
+Установка не нужна: Cursor при старте вызовет `pipx run zai-coding-gateway`, пакет подтянется с PyPI. Но Cursor не видит PATH из терминала, поэтому в `command` нужен **полный путь к pipx**.
+
+1. Установите pipx, если ещё нет: [pypa.github.io/pipx](https://pypa.github.io/pipx/) (`brew install pipx` на macOS, `pip install pipx` и т.п.).
+2. Запустите скрипт — он найдёт pipx на вашей платформе и выведет готовый фрагмент для `mcp.json`:
    ```bash
-   cp mcp.json.example mcp.json
+   python scripts/print_mcp_config.py
    ```
-2. Откройте `mcp.json` и в секции `env` подставьте свой `ZAI_API_KEY`.
-3. Добавьте содержимое `mcp.json` в настройки MCP Cursor (например, в `~/.cursor/mcp.json` или в настройках проекта в разделе MCP Servers). **При использовании в другом проекте** укажите в `env` путь к корню этого проекта: `"ZAI_PROJECT_ROOT": "/путь/к/проекту"` (Cursor пока не передаёт workspace через MCP roots/list). Формат:
+   Или из репозитория пакета (после клонирования): `python scripts/print_mcp_config.py`.
+3. Скопируйте вывод и вставьте в `~/.cursor/mcp.json` в объект `mcpServers` (если файла нет — создайте с обёрткой `{"mcpServers": { ... } }`).
+4. Вставьте в `env` свой `ZAI_API_KEY` и при необходимости `ZAI_PROJECT_ROOT`.
+5. Перезапустите MCP в Cursor (или перезапустите Cursor).
+
+Скрипт `print_mcp_config.py` поддерживает macOS, Linux и Windows и подставляет типичные пути к pipx. Если репозитория нет (только пакет с PyPI), подставьте путь к pipx вручную — типичные расположения:
+
+| Платформа | Типичный путь к pipx |
+|-----------|----------------------|
+| macOS (Homebrew) | `/opt/homebrew/bin/pipx` или `/usr/local/bin/pipx` |
+| Linux | `$HOME/.local/bin/pipx` или `/usr/bin/pipx` |
+| Windows | `%USERPROFILE%\.local\bin\pipx.exe` или через `where pipx` в cmd |
+
+В терминале: `which pipx` (macOS/Linux) или `where pipx` (Windows) — выведет путь для вашей системы.
+
+### Вариант: локальная разработка (pip install -e .)
+
+1. В проекте: `pip install -e .`
+2. В `mcp.json` укажите полный путь к тому же Python, в окружении которого установлен пакет, например:
    ```json
-   {
-     "mcpServers": {
-       "zai-coding-gateway": {
-         "command": "/путь/к/.venv/bin/python",
-         "args": ["-m", "zai_coding_gateway.main", "--stdio"],
-         "env": {
-           "ZAI_API_KEY": "ваш-ключ",
-           "ZAI_PROJECT_ROOT": "/путь/к/корню/проекта"
-         }
-       }
-     }
-   }
+   "command": "/путь/к/.venv/bin/python",
+   "args": ["-m", "zai_coding_gateway.main", "--stdio"],
    ```
-4. Убедитесь, что в PATH доступен тот же Python, в окружении которого установлен пакет (`pip install -e .`). Либо укажите полный путь к `python` в `command`.
+3. В `env` задайте `ZAI_API_KEY` и при необходимости `ZAI_PROJECT_ROOT`.
 
 ## Модели (work / fast)
 

zai_coding_gateway-0.1.1/mcp.json.example

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "zai-coding-gateway": {
+      "command": "/opt/homebrew/bin/pipx",
+      "args": ["run", "zai-coding-gateway", "--stdio"],
+      "env": {
+        "ZAI_API_KEY": "<подставьте свой ключ Z.AI>",
+        "ZAI_PROJECT_ROOT": "<путь к корню проекта или ${workspaceFolder}>"
+      }
+    }
+  }
+}

{zai_coding_gateway-0.1.0 → zai_coding_gateway-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "zai-coding-gateway"
-version = "0.1.0"
+version = "0.1.1"
 description = "MCP-сервер для решения задач в рабочем пространстве через Z.AI Coding Plan (solve_in_workspace, apply_changes)"
 readme = "README.md"
 requires-python = ">=3.11"

zai_coding_gateway-0.1.1/scripts/print_mcp_config.py

@@ -0,0 +1,76 @@
+#!/usr/bin/env python3
+"""
+Печатает фрагмент mcp.json с подставленным путём к pipx для текущей платформы.
+Cursor при запуске не видит PATH из терминала, поэтому command должен быть полным путём.
+Запуск: python scripts/print_mcp_config.py
+Вставьте вывод в ~/.cursor/mcp.json в секцию mcpServers.
+"""
+import os
+import platform
+import shutil
+import sys
+
+
+def find_pipx() -> str | None:
+    """Ищет исполняемый pipx: сначала PATH, потом типичные пути для платформы."""
+    exe = shutil.which("pipx")
+    if exe:
+        return os.path.abspath(exe)
+    system = platform.system()
+    home = os.path.expanduser("~")
+    if system == "Darwin":
+        candidates = [
+            "/opt/homebrew/bin/pipx",
+            "/usr/local/bin/pipx",
+            f"{home}/.local/bin/pipx",
+        ]
+    elif system == "Linux":
+        candidates = [
+            f"{home}/.local/bin/pipx",
+            "/usr/local/bin/pipx",
+            "/usr/bin/pipx",
+        ]
+    elif system == "Windows":
+        local = os.environ.get("LOCALAPPDATA", f"{home}/AppData/Local")
+        candidates = [
+            f"{home}/.local/bin/pipx.exe",
+            f"{local}/Programs/pipx/pipx.exe",
+            "pipx.exe",
+        ]
+    else:
+        candidates = [f"{home}/.local/bin/pipx", "pipx"]
+    for path in candidates:
+        if os.path.isfile(path) and os.access(path, os.X_OK):
+            return os.path.abspath(path)
+        if system == "Windows" and not path.endswith(".exe") and os.path.isfile(path + ".exe"):
+            return os.path.abspath(path + ".exe")
+    return None
+
+
+def main() -> None:
+    pipx_path = find_pipx()
+    if not pipx_path:
+        print(
+            "pipx не найден. Установите: https://pypa.github.io/pipx/\n"
+            "  macOS (Homebrew): brew install pipx && pipx ensurepath\n"
+            "  Windows: py -m pip install pipx && pipx ensurepath\n"
+            "  Linux: pip install --user pipx && pipx ensurepath",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    # Экранируем обратные слэши для JSON (Windows)
+    cmd = pipx_path.replace("\\", "\\\\")
+    block = f'''  "zai-coding-gateway": {{
+    "command": "{cmd}",
+    "args": ["run", "zai-coding-gateway", "--stdio"],
+    "env": {{
+      "ZAI_API_KEY": "<ваш ключ Z.AI>",
+      "ZAI_PROJECT_ROOT": "<путь к корню проекта или ${{workspaceFolder}}>"
+    }}
+  }}'''
+    print("# Вставьте этот блок в ~/.cursor/mcp.json в объект mcpServers:")
+    print(block)
+
+
+if __name__ == "__main__":
+    main()

zai_coding_gateway-0.1.0/mcp.json.example

@@ -1,12 +0,0 @@
-{
-  "mcpServers": {
-    "zai-coding-gateway": {
-      "command": "python",
-      "args": ["-m", "zai_coding_gateway.main", "--stdio"],
-      "env": {
-        "ZAI_API_KEY": "<подставьте свой ключ Z.AI>",
-        "ZAI_PROJECT_ROOT": "<рекомендуется: путь к корню открытого проекта; во многих IDE можно использовать переменную типа ${workspaceFolder}>"
-      }
-    }
-  }
-}