daepak-mcp 2.0.1__tar.gz

daepak_mcp-2.0.1/.gitignore

@@ -0,0 +1,53 @@
+# --- секреты и личное ---
+.env
+.env.*
+!.env.example
+CLAUDE.local.md
+
+# --- данные (бинарники не в git) ---
+*.db
+*.sqlite
+*.sqlite3
+data/
+*.log
+
+# --- Python ---
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+.python-version
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# --- OS / IDE ---
+.DS_Store
+.idea/
+.vscode/
+
+# playwright артефакты
+.playwright-mcp/
+
+# context-portal (conport) — локальная БД/логи машинной памяти, не в git
+context_portal/
+
+# graphify — граф зависимостей кода (машинный слой навигации, как индекс Serena);
+# генерируется локально из кода (graphify update .), не в git
+graphify-out/
+
+# приватный ключ обратного туннеля
+deploy/tunnel/
+backups/
+"Пустой 29.docx"
+docs/naver-review/*.pdf
+docs/deck/*.pdf
+docs/deck/shots/
+docs/deck/gen/
+src/crypto_radar/_recent_commits.txt
+
+# Beads / Dolt files (added by bd init)
+.dolt/
+.beads-credential-key
+.beads/proxieddb/

daepak_mcp-2.0.1/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.5
+Name: daepak-mcp
+Version: 2.0.1
+Summary: Daepak market intelligence tools over MCP
+Project-URL: Homepage, https://daepak.com
+License: MIT
+Keywords: crypto,korea,market-data,mcp,trading
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.10
+Requires-Dist: certifi>=2024.2.2
+Description-Content-Type: text/markdown
+
+# Daepak MCP
+
+Инструменты рыночной аналитики Daepak в любом движке с поддержкой MCP.
+
+## Подключение
+
+После публикации пакета:
+
+```bash
+claude mcp add daepak -e DAEPAK_API_KEY=dpk_live_… -- uvx daepak-mcp
+```
+
+Из репозитория, без установки:
+
+```bash
+claude mcp add daepak -e DAEPAK_API_KEY=dpk_live_… -- python3 /path/to/mcp/daepak_agent_mcp.py
+```
+
+Ключ заводится на странице **«Ключи»** в профиле. Зависимостей у сервера нет — только
+стандартная библиотека Python 3.11+.
+
+| переменная | по умолчанию | зачем |
+|---|---|---|
+| `DAEPAK_API_KEY` | — | ключ `dpk_live_…`, обязателен |
+| `DAEPAK_BASE_URL` | `https://daepak.com` | другой контур (стейдж) |
+| `DAEPAK_TIMEOUT` | `120` | секунд на вызов |
+
+## Что видит движок
+
+Каталог приходит **отфильтрованным по правам ключа**: движок видит только то, что
+действительно может вызвать, а не список с отказами. У каждого инструмента в описании
+указана цена в кредитах — бюджет считается до вызова, а не по факту.
+
+⚠️ **Владелец определяется ключом.** Назвать чужого пользователя в запросе нельзя.
+До 30.08.2026 это было можно — и именно поэтому прежний мост не годился как публичный API.
+
+## Права
+
+| скоуп | что открывает |
+|---|---|
+| `read:market` | цены, свечи, индикаторы, скор, уровни, нарративы, деривативы |
+| `read:korea` | кимчи-премия, листинги Upbit, корейские бумаги |
+| `read:us` | акции США, премаркет, гэп-статистика, опционы |
+| `read:personal` | свои позиции, портфель, журнал, память |
+| `write:personal` | запись в них же |
+| `agent:chat` | ответы агента целиком |
+
+Право читать не даёт права писать: это отдельный скоуп.
+
+## Цены
+
+| разряд | что | кредитов |
+|---|---|---|
+| своя база | цена, индикаторы, скор, уровни, свечи | 1 |
+| внешний вызов | акции, токены, опционы, он-чейн | 5 |
+| эмбеддинг и песочница | поиск новостей, исполнение кода | 20 |
+
+Месячные кредиты и потолок частоты — по тарифу; текущий расход виден в `GET /v1/usage`.
+
+## Когда кредиты кончились
+
+Приходит `402` с двумя выходами: перейти на тариф выше (в ответе указан следующий и
+сколько кредитов он даёт) или дождаться обновления в начале месяца.
+
+⚠️ Счёта за перерасход **нет**: обслуживать в долг значит прислать счёт, которого никто
+не ждал. Но и отказ без выхода читался бы как поломка, поэтому ответ всегда называет,
+что делать.
+
+## Публикация (для владельца)
+
+```bash
+cd mcp && python -m build && python -m twine upload dist/*
+```
+
+⚠️ `certifi` в зависимостях вынужденно: на чистом venv без него КАЖДЫЙ вызов падает с
+`CERTIFICATE_VERIFY_FAILED` — сборки Python для macOS не читают системное хранилище
+сертификатов. Проверено установкой собранного пакета в пустое окружение.

daepak_mcp-2.0.1/README.md

@@ -0,0 +1,77 @@
+# Daepak MCP
+
+Инструменты рыночной аналитики Daepak в любом движке с поддержкой MCP.
+
+## Подключение
+
+После публикации пакета:
+
+```bash
+claude mcp add daepak -e DAEPAK_API_KEY=dpk_live_… -- uvx daepak-mcp
+```
+
+Из репозитория, без установки:
+
+```bash
+claude mcp add daepak -e DAEPAK_API_KEY=dpk_live_… -- python3 /path/to/mcp/daepak_agent_mcp.py
+```
+
+Ключ заводится на странице **«Ключи»** в профиле. Зависимостей у сервера нет — только
+стандартная библиотека Python 3.11+.
+
+| переменная | по умолчанию | зачем |
+|---|---|---|
+| `DAEPAK_API_KEY` | — | ключ `dpk_live_…`, обязателен |
+| `DAEPAK_BASE_URL` | `https://daepak.com` | другой контур (стейдж) |
+| `DAEPAK_TIMEOUT` | `120` | секунд на вызов |
+
+## Что видит движок
+
+Каталог приходит **отфильтрованным по правам ключа**: движок видит только то, что
+действительно может вызвать, а не список с отказами. У каждого инструмента в описании
+указана цена в кредитах — бюджет считается до вызова, а не по факту.
+
+⚠️ **Владелец определяется ключом.** Назвать чужого пользователя в запросе нельзя.
+До 30.08.2026 это было можно — и именно поэтому прежний мост не годился как публичный API.
+
+## Права
+
+| скоуп | что открывает |
+|---|---|
+| `read:market` | цены, свечи, индикаторы, скор, уровни, нарративы, деривативы |
+| `read:korea` | кимчи-премия, листинги Upbit, корейские бумаги |
+| `read:us` | акции США, премаркет, гэп-статистика, опционы |
+| `read:personal` | свои позиции, портфель, журнал, память |
+| `write:personal` | запись в них же |
+| `agent:chat` | ответы агента целиком |
+
+Право читать не даёт права писать: это отдельный скоуп.
+
+## Цены
+
+| разряд | что | кредитов |
+|---|---|---|
+| своя база | цена, индикаторы, скор, уровни, свечи | 1 |
+| внешний вызов | акции, токены, опционы, он-чейн | 5 |
+| эмбеддинг и песочница | поиск новостей, исполнение кода | 20 |
+
+Месячные кредиты и потолок частоты — по тарифу; текущий расход виден в `GET /v1/usage`.
+
+## Когда кредиты кончились
+
+Приходит `402` с двумя выходами: перейти на тариф выше (в ответе указан следующий и
+сколько кредитов он даёт) или дождаться обновления в начале месяца.
+
+⚠️ Счёта за перерасход **нет**: обслуживать в долг значит прислать счёт, которого никто
+не ждал. Но и отказ без выхода читался бы как поломка, поэтому ответ всегда называет,
+что делать.
+
+## Публикация (для владельца)
+
+```bash
+cd mcp && python -m build && python -m twine upload dist/*
+```
+
+⚠️ `certifi` в зависимостях вынужденно: на чистом venv без него КАЖДЫЙ вызов падает с
+`CERTIFICATE_VERIFY_FAILED` — сборки Python для macOS не читают системное хранилище
+сертификатов. Проверено установкой собранного пакета в пустое окружение.

daepak_mcp-2.0.1/daepak_agent_mcp.py

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+"""MCP-сервер Daepak: инструменты рыночной аналитики в любой движок с MCP.
+
+Сервер ничего не описывает сам: тянет каталог с `GET /v1/tools`, то есть видит ровно то,
+что разрешено ключу, и не расходится с продуктом при добавлении инструментов.
+
+Подключение:
+
+  claude mcp add daepak \
+    -e DAEPAK_API_KEY=dpk_live_… \
+    -- python3 /path/to/mcp/daepak_agent_mcp.py
+
+Ключ заводится на странице «Ключи» в профиле. ⚠️ Владелец определяется КЛЮЧОМ: назвать
+чужого пользователя в запросе нельзя — до 30.08.2026 это было можно, и именно поэтому
+мост не годился как публичный API.
+
+Каталог приходит уже отфильтрованным по правам ключа: движок видит только то, что
+действительно может вызвать, а не список с отказами. У каждого инструмента объявлена
+цена в кредитах — её видно в описании, чтобы бюджет считался ДО вызова.
+
+Протокол: MCP 2024-11-05, JSON-RPC поверх stdin/stdout. Зависимостей нет.
+"""
+from __future__ import annotations
+
+import json
+import os
+import ssl
+import sys
+import urllib.error
+import urllib.request
+
+BASE = os.getenv("DAEPAK_BASE_URL", "https://daepak.com").rstrip("/")
+KEY = os.getenv("DAEPAK_API_KEY", "")
+TIMEOUT = float(os.getenv("DAEPAK_TIMEOUT", "120"))
+# ⚠️ DAEPAK_USER_ID больше НЕ читается. Раньше им называли владельца в теле запроса —
+# держатель общего ключа мог указать любого и получить чужие позиции и память.
+
+# ⚠️ certifi обязателен, а не «желателен»: сборки Python для macOS не читают системное
+# хранилище сертификатов, и без него КАЖДЫЙ вызов падает с CERTIFICATE_VERIFY_FAILED.
+# Откат ниже оставлен для окружений, где сертификаты в системе есть (Linux-дистрибутивы).
+try:
+    import certifi
+    _SSL_CTX = ssl.create_default_context(cafile=certifi.where())
+except ImportError:
+    _SSL_CTX = ssl.create_default_context()
+
+
+def _http(method: str, path: str, body: dict | None = None) -> dict | list:
+    req = urllib.request.Request(
+        BASE + path, method=method,
+        data=json.dumps(body, ensure_ascii=False).encode() if body is not None else None,
+        headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"})
+    try:
+        with urllib.request.urlopen(req, timeout=TIMEOUT, context=_SSL_CTX) as r:
+            return json.loads(r.read().decode())
+    except urllib.error.HTTPError as e:
+        return {"error": f"HTTP {e.code}", "detail": e.read().decode()[:500]}
+    except Exception as e:  # noqa: BLE001 — сеть/таймаут: движок должен увидеть причину, а не молчание
+        return {"error": f"{type(e).__name__}: {e}"}
+
+
+def _to_mcp(schema: dict) -> dict | None:
+    """OpenAI function-schema → MCP tool. Формы обе: {"function":{...}} и плоская."""
+    fn = schema.get("function") if isinstance(schema.get("function"), dict) else schema
+    name = fn.get("name")
+    if not name:
+        return None
+    params = fn.get("parameters") or {"type": "object", "properties": {}}
+    desc = (fn.get("description") or "")[:1000]
+    price = schema.get("credits") or fn.get("credits")
+    if price:                       # цена рядом с описанием: бюджет считается ДО вызова
+        desc = f"{desc}\n[стоимость: {price} кредит(ов)]"
+    return {"name": name, "description": desc[:1024], "inputSchema": params}
+
+
+_tools_cache: list[dict] | None = None
+
+
+def tools() -> list[dict]:
+    """Схемы с моста. Кэшируем: список не меняется в пределах запуска сервера."""
+    global _tools_cache
+    if _tools_cache is None:
+        got = _http("GET", "/v1/tools")
+        raw = got.get("tools") if isinstance(got, dict) else None
+        if not raw:
+            # мост недоступен — отдаём пустой список; движок сообщит, что тулзов нет,
+            # вместо того чтобы падать на каждом вызове
+            err = got.get("error") if isinstance(got, dict) else "нет ответа"
+            print(f"[daepak-mcp] каталог недоступен: {err}", file=sys.stderr, flush=True)
+            return []
+        _tools_cache = [t for t in (_to_mcp(s) for s in raw) if t]
+        print(f"[daepak-mcp] инструментов доступно ключу: {len(_tools_cache)} · {BASE}",
+              file=sys.stderr, flush=True)
+    return _tools_cache
+
+
+def call_tool(name: str, args: dict) -> dict | list:
+    """Вызов инструмента. Владелец берётся из ключа — в теле его нет и быть не может."""
+    out = _http("POST", f"/v1/tools/{name}", args or {})
+    # /v1 заворачивает результат вместе с расходом; движку нужны данные, а не обёртка,
+    # но цену и время оставляем рядом — по ним видно, во что обошёлся шаг
+    if isinstance(out, dict) and "data" in out:
+        data = out["data"]
+        if isinstance(data, dict):
+            return {**data, "_credits": out.get("credits_used"), "_ms": out.get("took_ms")}
+        return data
+    return out
+
+
+def main() -> None:
+    for line in sys.stdin:
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            msg = json.loads(line)
+        except json.JSONDecodeError:
+            continue
+        mid = msg.get("id")
+        method = msg.get("method", "")
+        if method == "initialize":
+            resp = {"protocolVersion": "2024-11-05",
+                    "capabilities": {"tools": {}},
+                    "serverInfo": {"name": "daepak-agent", "version": "2.0.0"}}
+        elif method == "tools/list":
+            resp = {"tools": tools()}
+        elif method == "tools/call":
+            p = msg.get("params") or {}
+            out = call_tool(p.get("name", ""), p.get("arguments") or {})
+            resp = {"content": [{"type": "text", "text": json.dumps(out, ensure_ascii=False)}],
+                    "isError": bool(isinstance(out, dict) and out.get("error"))}
+        elif method in ("notifications/initialized", "notifications/cancelled"):
+            continue                      # уведомления — без ответа
+        elif mid is None:
+            continue
+        else:
+            sys.stdout.write(json.dumps(
+                {"jsonrpc": "2.0", "id": mid,
+                 "error": {"code": -32601, "message": f"method not found: {method}"}}) + "\n")
+            sys.stdout.flush()
+            continue
+        sys.stdout.write(json.dumps({"jsonrpc": "2.0", "id": mid, "result": resp},
+                                    ensure_ascii=False) + "\n")
+        sys.stdout.flush()
+
+
+if __name__ == "__main__":
+    main()

daepak_mcp-2.0.1/pyproject.toml

@@ -0,0 +1,40 @@
+# Упаковка MCP-сервера. Публикация — одна команда владельца:
+#   cd mcp && python -m build && python -m twine upload dist/*
+# После этого подключение к любому движку становится:
+#   claude mcp add daepak -e DAEPAK_API_KEY=dpk_live_… -- uvx daepak-mcp
+#
+# ⚠️ Единственная зависимость — certifi, и она вынужденная. Сервер писался «без
+# зависимостей», но проверка на чистом venv показала: без certifi вызов падает с
+# CERTIFICATE_VERIFY_FAILED (сборки Python для macOS не используют системное хранилище
+# сертификатов). У меня это не воспроизводилось, потому что certifi стоял в окружении
+# проекта. Красивый принцип «ноль зависимостей» здесь означал бы сломанную установку у
+# целой платформы.
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "daepak-mcp"
+version = "2.0.1"
+description = "Daepak market intelligence tools over MCP"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+keywords = ["mcp", "market-data", "crypto", "korea", "trading"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Topic :: Office/Business :: Financial :: Investment",
+]
+dependencies = ["certifi>=2024.2.2"]
+
+[project.urls]
+Homepage = "https://daepak.com"
+
+[project.scripts]
+daepak-mcp = "daepak_agent_mcp:main"
+
+[tool.hatch.build.targets.wheel]
+include = ["daepak_agent_mcp.py"]
+
+[tool.hatch.build.targets.sdist]
+include = ["daepak_agent_mcp.py", "README.md", "pyproject.toml"]