python-1c-mcp 0.1.0__py3-none-any.whl

python_1c_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""Read-only MCP server for 1C:Enterprise standard OData."""
+
+__version__ = "0.1.0"

python_1c_mcp/connection.py

@@ -0,0 +1,130 @@
+"""Environment-based Infobase connection (one shared session per process)."""
+
+from __future__ import annotations
+
+import asyncio
+import os
+from dataclasses import dataclass
+from urllib.parse import unquote, urlparse
+
+from python_1c_odata import Infobase
+
+_FORMATS = frozenset({"json", "atom", "auto"})
+_TRUTHY = frozenset({"1", "true", "yes", "on"})
+
+
+class ConfigError(ValueError):
+    """Missing or invalid connection settings."""
+
+
+@dataclass(frozen=True)
+class ConnectionConfig:
+    server: str
+    infobase: str
+    username: str
+    password: str
+    format: str = "json"
+    debug: bool = False
+
+
+_lock = asyncio.Lock()
+_infobase: Infobase | None = None
+_config: ConnectionConfig | None = None
+
+
+def parse_onec_url(url: str) -> ConnectionConfig:
+    """Parse ``http://user:pass@host:port/publication`` into connection fields."""
+    parsed = urlparse(url.strip())
+    if parsed.scheme not in {"http", "https"}:
+        raise ConfigError(f"ONEC_URL scheme must be http or https, got {parsed.scheme!r}")
+    if not parsed.hostname:
+        raise ConfigError("ONEC_URL must include a host")
+    if not parsed.username or parsed.password is None:
+        raise ConfigError("ONEC_URL must include user:pass@ in the authority")
+    path = parsed.path.strip("/")
+    if not path:
+        raise ConfigError("ONEC_URL must include the infobase publication path")
+    port = f":{parsed.port}" if parsed.port else ""
+    server = f"{parsed.scheme}://{parsed.hostname}{port}"
+    return ConnectionConfig(
+        server=server,
+        infobase=path.split("/")[0],
+        username=unquote(parsed.username),
+        password=unquote(parsed.password),
+        format=os.environ.get("ONEC_FORMAT", "json"),
+        debug=os.environ.get("ONEC_DEBUG", "").lower() in _TRUTHY,
+    )
+
+
+def load_config() -> ConnectionConfig:
+    """Load connection settings from environment variables."""
+    url = os.environ.get("ONEC_URL")
+    if url:
+        cfg = parse_onec_url(url)
+    else:
+        missing = [
+            name
+            for name, value in (
+                ("ONEC_SERVER", os.environ.get("ONEC_SERVER")),
+                ("ONEC_INFOBASE", os.environ.get("ONEC_INFOBASE")),
+                ("ONEC_USER", os.environ.get("ONEC_USER")),
+                ("ONEC_PASSWORD", os.environ.get("ONEC_PASSWORD")),
+            )
+            if not value
+        ]
+        if missing:
+            raise ConfigError(
+                "Missing required environment variable(s): "
+                + ", ".join(missing)
+                + ". Set them individually or use ONEC_URL=http://user:pass@host/base"
+            )
+        fmt = os.environ.get("ONEC_FORMAT", "json")
+        cfg = ConnectionConfig(
+            server=os.environ["ONEC_SERVER"].strip(),
+            infobase=os.environ["ONEC_INFOBASE"].strip(),
+            username=os.environ["ONEC_USER"],
+            password=os.environ["ONEC_PASSWORD"],
+            format=fmt,
+            debug=os.environ.get("ONEC_DEBUG", "").lower() in _TRUTHY,
+        )
+    if cfg.format not in _FORMATS:
+        raise ConfigError(f"ONEC_FORMAT must be one of {sorted(_FORMATS)}, got {cfg.format!r}")
+    return cfg
+
+
+def validate_config() -> ConnectionConfig:
+    """Validate env at startup; cache config for lazy Infobase init."""
+    global _config
+    _config = load_config()
+    return _config
+
+
+def _build_infobase(cfg: ConnectionConfig) -> Infobase:
+    return Infobase(
+        cfg.server,
+        cfg.infobase,
+        cfg.username,
+        cfg.password,
+        format=cfg.format,
+        debug=cfg.debug,
+    )
+
+
+async def get_infobase() -> Infobase:
+    """Return the shared Infobase, creating the HTTP session on first use."""
+    global _infobase
+    async with _lock:
+        if _infobase is None:
+            cfg = _config if _config is not None else load_config()
+            _infobase = _build_infobase(cfg)
+        await _infobase._ensure_session()
+        return _infobase
+
+
+async def close_infobase() -> None:
+    """Close the shared HTTP session."""
+    global _infobase
+    async with _lock:
+        if _infobase is not None:
+            await _infobase.aclose()
+            _infobase = None

python_1c_mcp/entity_set.py

@@ -0,0 +1,19 @@
+"""Generic entity-set access by full OData name (Catalog_*, Document_*, ...)."""
+
+from __future__ import annotations
+
+from python_1c_odata.client import Infobase
+from python_1c_odata.entity import EntitySet
+
+
+class NamedEntitySet(EntitySet):
+    """Query any published entity set using its full name (e.g. ``Catalog_Товары``)."""
+
+    kind = ""
+
+    def __init__(self, infobase: Infobase, full_name: str) -> None:
+        super().__init__(infobase, full_name)
+
+    @property
+    def entity(self) -> str:
+        return self.name

python_1c_mcp/server.py

@@ -0,0 +1,150 @@
+"""Read-only MCP server for 1C:Enterprise standard OData."""
+
+from __future__ import annotations
+
+import logging
+import sys
+from collections.abc import AsyncIterator
+from contextlib import asynccontextmanager
+
+from mcp.server.mcpserver import MCPServer
+
+from python_1c_mcp.connection import ConfigError, close_infobase, validate_config
+from python_1c_mcp.tools import handlers
+
+_LOG = logging.getLogger("python_1c_mcp")
+
+INSTRUCTIONS = """\
+Read-only MCP server for 1C:Enterprise standard OData (platform 8.3.5+, standard.odata publication).
+
+Available read operations only — no create, update, delete, or post/unpost.
+Use list_entity_sets and describe_entity_set to discover schema, then odata_query or get_entity.
+"""
+
+
+@asynccontextmanager
+async def _lifespan(_server: MCPServer) -> AsyncIterator[None]:
+    try:
+        yield
+    finally:
+        await close_infobase()
+
+
+mcp = MCPServer(
+    "python-1c-mcp",
+    title="1C OData (read-only)",
+    instructions=INSTRUCTIONS,
+    lifespan=_lifespan,
+)
+
+
+@mcp.tool(
+    name="list_entity_sets",
+    description=(
+        "List all OData entity set names published by the connected 1C infobase "
+        "(Catalog_*, Document_*, register names, etc.). Read-only."
+    ),
+)
+async def list_entity_sets() -> dict:
+    return await handlers.list_entity_sets()
+
+
+@mcp.tool(
+    name="describe_entity_set",
+    description=(
+        "Describe keys, scalar properties, and navigation properties for one entity set. "
+        "Pass the full set name, e.g. Catalog_Товары. Read-only."
+    ),
+)
+async def describe_entity_set(entity_set: str) -> dict:
+    return await handlers.describe_entity_set(entity_set)
+
+
+@mcp.tool(
+    name="odata_query",
+    description=(
+        "Run a read-only OData query against an entity set. Supports $filter, $select, "
+        "$top (default 20, max 100), $skip, $orderby, and $inlinecount. Read-only."
+    ),
+)
+async def odata_query(
+    entity_set: str,
+    odata_filter: str | None = None,
+    select: str | None = None,
+    top: int = 20,
+    skip: int | None = None,
+    orderby: str | None = None,
+    inlinecount: bool = False,
+) -> dict:
+    return await handlers.odata_query(
+        entity_set,
+        odata_filter=odata_filter,
+        select=select,
+        top=top,
+        skip=skip,
+        orderby=orderby,
+        inlinecount=inlinecount,
+    )
+
+
+@mcp.tool(
+    name="get_entity",
+    description=(
+        "Fetch a single entity record by Ref_Key GUID from an entity set. Read-only."
+    ),
+)
+async def get_entity(
+    entity_set: str,
+    ref_key: str,
+    select: str | None = None,
+) -> dict:
+    return await handlers.get_entity(entity_set, ref_key, select=select)
+
+
+@mcp.tool(
+    name="get_metadata",
+    description=(
+        "Return OData $metadata summary (entity set count and sample names). "
+        "Set raw_xml=true for truncated XML. Read-only."
+    ),
+)
+async def get_metadata(raw_xml: bool = False) -> dict:
+    return await handlers.get_metadata(raw_xml=raw_xml)
+
+
+@mcp.resource(
+    "1c://entity-sets",
+    name="entity-sets",
+    description="Cached list of all OData entity set names from $metadata.",
+    mime_type="text/plain",
+)
+async def entity_sets_resource() -> str:
+    return await handlers.resource_entity_sets()
+
+
+@mcp.resource(
+    "1c://metadata",
+    name="metadata",
+    description="Raw or truncated $metadata XML from the connected infobase.",
+    mime_type="application/xml",
+)
+async def metadata_resource() -> str:
+    return await handlers.resource_metadata()
+
+
+def main() -> None:
+    logging.basicConfig(
+        level=logging.INFO,
+        format="%(levelname)s %(name)s: %(message)s",
+        stream=sys.stderr,
+    )
+    try:
+        validate_config()
+    except ConfigError as exc:
+        print(f"python-1c-mcp: {exc}", file=sys.stderr)
+        sys.exit(1)
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()

python_1c_mcp/tools/__init__.py

@@ -0,0 +1 @@
+"""Read-only tool handlers."""

python_1c_mcp/tools/handlers.py

@@ -0,0 +1,139 @@
+"""Read-only MCP tool implementations."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from python_1c_odata.metadata import EntityTypeInfo
+
+from python_1c_mcp.connection import get_infobase
+from python_1c_mcp.entity_set import NamedEntitySet
+
+_LIST_TRUNCATE_AT = 500
+_METADATA_XML_LIMIT = 8000
+_DEFAULT_TOP = 20
+_MAX_TOP = 100
+
+
+def entity_type_to_dict(info: EntityTypeInfo) -> dict[str, Any]:
+    return {
+        "name": info.name,
+        "keys": list(info.keys),
+        "properties": [
+            {"name": prop.name, "type": prop.type, "nullable": prop.nullable}
+            for prop in info.properties
+        ],
+        "navigation_properties": list(info.navigation_properties),
+    }
+
+
+async def list_entity_sets() -> dict[str, Any]:
+    ib = await get_infobase()
+    names = await ib.entity_sets()
+    total = len(names)
+    truncated = total > _LIST_TRUNCATE_AT
+    if truncated:
+        names = names[:_LIST_TRUNCATE_AT]
+    result: dict[str, Any] = {
+        "total": total,
+        "entity_sets": names,
+        "truncated": truncated,
+    }
+    if truncated:
+        result["message"] = (
+            f"Listing truncated to first {_LIST_TRUNCATE_AT} of {total} entity sets."
+        )
+    return result
+
+
+async def describe_entity_set(entity_set: str) -> dict[str, Any]:
+    ib = await get_infobase()
+    info = await ib.entity_type_for_set(entity_set)
+    return entity_type_to_dict(info)
+
+
+async def odata_query(
+    entity_set: str,
+    *,
+    odata_filter: str | None = None,
+    select: str | None = None,
+    top: int = _DEFAULT_TOP,
+    skip: int | None = None,
+    orderby: str | None = None,
+    inlinecount: bool = False,
+) -> dict[str, Any]:
+    if top < 1:
+        raise ValueError("top must be at least 1")
+    if top > _MAX_TOP:
+        raise ValueError(f"top cannot exceed {_MAX_TOP}")
+    if skip is not None and skip < 0:
+        raise ValueError("skip must be non-negative")
+
+    ib = await get_infobase()
+    es = NamedEntitySet(ib, entity_set)
+    page = await es.query(
+        top=top,
+        skip=skip,
+        select=select.split(",") if select else None,
+        odata_filter=odata_filter,
+        orderby=orderby,
+        inlinecount=inlinecount,
+    )
+    payload: dict[str, Any] = {
+        "entity_set": entity_set,
+        "value": page.value,
+        "count": len(page.value),
+    }
+    if inlinecount and page.count is not None:
+        payload["inlinecount"] = page.count
+    return payload
+
+
+async def get_entity(
+    entity_set: str,
+    ref_key: str,
+    *,
+    select: str | None = None,
+) -> dict[str, Any]:
+    ib = await get_infobase()
+    es = NamedEntitySet(ib, entity_set)
+    record = await es.get(
+        ref_key,
+        select=select.split(",") if select else None,
+    )
+    return {"entity_set": entity_set, "ref_key": ref_key, "record": record}
+
+
+async def get_metadata(*, raw_xml: bool = False) -> dict[str, Any]:
+    ib = await get_infobase()
+    if raw_xml:
+        xml = await ib.metadata()
+        truncated = len(xml) > _METADATA_XML_LIMIT
+        return {
+            "raw_xml": xml[:_METADATA_XML_LIMIT],
+            "length": len(xml),
+            "truncated": truncated,
+        }
+
+    names = await ib.entity_sets()
+    sample = names[:10]
+    return {
+        "entity_set_count": len(names),
+        "sample_entity_sets": sample,
+        "odata_root": ib.root,
+    }
+
+
+async def resource_entity_sets() -> str:
+    ib = await get_infobase()
+    names = await ib.entity_sets()
+    lines = [f"{index + 1}. {name}" for index, name in enumerate(names)]
+    return "1C OData entity sets:\n" + "\n".join(lines)
+
+
+async def resource_metadata() -> str:
+    ib = await get_infobase()
+    xml = await ib.metadata()
+    if len(xml) > _METADATA_XML_LIMIT:
+        return xml[:_METADATA_XML_LIMIT] + f"\n\n... truncated ({len(xml)} bytes total)"
+    return xml

python_1c_mcp-0.1.0.dist-info/METADATA

@@ -0,0 +1,335 @@
+Metadata-Version: 2.4
+Name: python-1c-mcp
+Version: 0.1.0
+Summary: Read-only MCP server for 1C:Enterprise standard OData (8.3.5+)
+Author-email: Artem Gulyaev <itsuppartem@yandex.ru>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/itsuppartem/python_1c_mcp
+Project-URL: Repository, https://github.com/itsuppartem/python_1c_mcp
+Project-URL: Issues, https://github.com/itsuppartem/python_1c_mcp/issues
+Keywords: 1c,odata,mcp,1c-enterprise,model-context-protocol
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-1c-odata>=0.6.0
+Requires-Dist: mcp>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
+Requires-Dist: ruff>=0.8; extra == "dev"
+Requires-Dist: mypy>=1.13; extra == "dev"
+Requires-Dist: aiohttp>=3.9.0; extra == "dev"
+Dynamic: license-file
+
+English | [Русский](#russkiy)
+
+# python-1c-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/python-1c-mcp.svg)](https://pypi.org/project/python-1c-mcp/)
+[![Python versions](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://github.com/itsuppartem/python_1c_mcp)
+[![CI](https://github.com/itsuppartem/python_1c_mcp/actions/workflows/test.yml/badge.svg)](https://github.com/itsuppartem/python_1c_mcp/actions/workflows/test.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/itsuppartem/python_1c_mcp/blob/main/LICENSE)
+
+Read-only [Model Context Protocol](https://modelcontextprotocol.io/) server for **1C:Enterprise standard OData** (`standard.odata`, platform **8.3.5+**).
+
+Built on [python-1c-odata](https://github.com/itsuppartem/python_1c_odata). Exposes schema discovery and OData queries to LLM agents in Claude Desktop, Cursor, and other MCP hosts.
+
+Homepage / repo: https://github.com/itsuppartem/python_1c_mcp
+
+## Read-only scope
+
+This server provides **read-only** access only:
+
+- List and describe entity sets from `$metadata`
+- Query entity sets (`$filter`, `$select`, `$top`, `$skip`, `$orderby`, `$inlinecount`)
+- Fetch a single record by `Ref_Key`
+
+There are **no** create, update, delete, post, or unpost tools.
+
+**Honest limits:** standard OData 3.0 publication only. No 8.2, 7.7, SOAP, COM, or proprietary APIs. Oldest publication is 8.3.5 Atom (`ONEC_FORMAT=atom` or `auto`). JSON is the default (`8.3.6+`).
+
+## Install
+
+```bash
+pip install python-1c-mcp
+```
+
+Python 3.10+. Depends on `python-1c-odata` 0.6.0+ and `mcp` 2.0+. From a clone:
+
+```bash
+git clone https://github.com/itsuppartem/python_1c_mcp.git
+cd python_1c_mcp
+pip install -e ".[dev]"
+```
+
+## Connect to 1C
+
+This server talks to a **published standard OData** interface on 1C:Enterprise **8.3.5+**. It does not open Designer, the thick/thin client, SOAP `/ws/`, custom HTTP services (`/hs/`), COM, 8.2, or 7.7. If OData is not published, there is no other way for this MCP to “log into 1C”.
+
+On the 1C side:
+
+1. Publish the infobase on the web server (Apache or IIS) from Designer: **Administration → Publish on web server**.
+2. Enable the standard OData interface for that publication (`enableStandardOData` / the OData checkbox). The service path is `/odata/standard.odata`.
+3. Create or pick a user who is allowed to use that publication (HTTP Basic). This is the web-service login, not an interactive Designer session.
+
+URL shape from the four variables:
+
+`{ONEC_SERVER}/{ONEC_INFOBASE}/odata/standard.odata`
+
+Example: `ONEC_SERVER=http://1c.example`, `ONEC_INFOBASE=trade` → `http://1c.example/trade/odata/standard.odata`.
+
+8.3.5 publications speak Atom only — set `ONEC_FORMAT=atom` (or `auto`). 8.3.6+ can use the default JSON.
+
+Auth is HTTP Basic: `ONEC_USER` / `ONEC_PASSWORD` (or `user:pass@` inside `ONEC_URL`). Then add the MCP JSON below in Cursor or Claude Desktop.
+
+## Connection (environment variables)
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ONEC_SERVER` | Yes* | Server base URL, e.g. `http://1c.example` |
+| `ONEC_INFOBASE` | Yes* | Publication name, e.g. `trade` |
+| `ONEC_USER` | Yes* | OData user |
+| `ONEC_PASSWORD` | Yes* | OData password |
+| `ONEC_URL` | Alt. | Single URL: `http://user:pass@host/publication` (overrides the four vars above) |
+| `ONEC_FORMAT` | No | Response format: `json` (default), `atom`, or `auto` |
+| `ONEC_DEBUG` | No | If `true` / `1` / `yes` / `on`, log HTTP requests to stderr |
+
+\* Either set `ONEC_URL` **or** all four of `ONEC_SERVER`, `ONEC_INFOBASE`, `ONEC_USER`, `ONEC_PASSWORD`.
+
+The server validates configuration at startup and exits with a clear stderr message if settings are missing.
+
+## MCP configuration
+
+### Claude Desktop / Cursor
+
+```json
+{
+  "mcpServers": {
+    "1c-odata": {
+      "command": "python",
+      "args": ["-m", "python_1c_mcp.server"],
+      "env": {
+        "ONEC_SERVER": "http://1c.example",
+        "ONEC_INFOBASE": "trade",
+        "ONEC_USER": "odata_user",
+        "ONEC_PASSWORD": "secret"
+      }
+    }
+  }
+}
+```
+
+Alternatively, use the console script:
+
+```json
+{
+  "mcpServers": {
+    "1c-odata": {
+      "command": "python-1c-mcp",
+      "env": {
+        "ONEC_URL": "http://odata_user:secret@1c.example/trade"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Parameters | Description |
+|------|------------|-------------|
+| `list_entity_sets` | — | All entity set names from `$metadata` (truncated after 500) |
+| `describe_entity_set` | `entity_set` | Keys, properties, navigation for one set (e.g. `Catalog_Товары`) |
+| `odata_query` | `entity_set`, `odata_filter`, `select`, `top`, `skip`, `orderby`, `inlinecount` | Read-only collection query. `top` default 20, max 100 |
+| `get_entity` | `entity_set`, `ref_key`, `select` | Single record by `Ref_Key` GUID |
+| `get_metadata` | `raw_xml` | Summary (count + sample names) or truncated raw `$metadata` XML |
+
+## Resources
+
+| URI | Description |
+|-----|-------------|
+| `1c://entity-sets` | Plain-text list of entity set names |
+| `1c://metadata` | `$metadata` XML (truncated if large) |
+
+## What is still missing
+
+| Missing | Notes |
+| --- | --- |
+| Write tools | no create / edit / delete / post / unpost — this package is read-only |
+| 8.2 / 7.7 / SOAP / COM / `/hs/` / OData 4 | out of scope. Oldest publication we speak is 8.3.5 Atom |
+
+## Development
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+ruff check src tests
+mypy src
+```
+
+## License
+
+MIT — Artem Gulyaev
+
+---
+
+<h2 id="russkiy">Русский</h2>
+
+# python-1c-mcp
+
+[English](#python-1c-mcp) | Русский
+
+[![PyPI](https://img.shields.io/pypi/v/python-1c-mcp.svg)](https://pypi.org/project/python-1c-mcp/)
+[![Python versions](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://github.com/itsuppartem/python_1c_mcp)
+[![CI](https://github.com/itsuppartem/python_1c_mcp/actions/workflows/test.yml/badge.svg)](https://github.com/itsuppartem/python_1c_mcp/actions/workflows/test.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/itsuppartem/python_1c_mcp/blob/main/LICENSE)
+
+Сервер [Model Context Protocol](https://modelcontextprotocol.io/) **только для чтения** стандартного OData **1С:Предприятие** (`standard.odata`, платформа **8.3.5+**).
+
+Собран на [python-1c-odata](https://github.com/itsuppartem/python_1c_odata). Отдаёт агентам LLM в Claude Desktop, Cursor и других MCP-хостах схему и запросы OData.
+
+Репозиторий: https://github.com/itsuppartem/python_1c_mcp
+
+## Область только чтения
+
+Сервер даёт доступ **только на чтение**:
+
+- Список и описание наборов сущностей из `$metadata`
+- Запросы к наборам (`$filter`, `$select`, `$top`, `$skip`, `$orderby`, `$inlinecount`)
+- Одна запись по `Ref_Key`
+
+Инструментов создания, изменения, удаления, проведения и отмены проведения **нет**.
+
+**Честные границы:** только стандартная публикация OData 3.0. Нет 8.2, 7.7, SOAP, COM и закрытых API. Самая старая публикация — Atom 8.3.5 (`ONEC_FORMAT=atom` или `auto`). По умолчанию JSON (`8.3.6+`).
+
+## Установка
+
+```bash
+pip install python-1c-mcp
+```
+
+Нужен Python 3.10+. Зависимости: `python-1c-odata` 0.6.0+ и `mcp` 2.0+. Из клона:
+
+```bash
+git clone https://github.com/itsuppartem/python_1c_mcp.git
+cd python_1c_mcp
+pip install -e ".[dev]"
+```
+
+## Подключение к 1С
+
+Сервер ходит в **опубликованный стандартный OData** на 1С:Предприятие **8.3.5+**. Он не открывает Конфигуратор, толстый/тонкий клиент, SOAP `/ws/`, произвольные HTTP-сервисы (`/hs/`), COM, 8.2 и 7.7. Если OData не опубликован, другим способом «войти в 1С» этот MCP не умеет.
+
+На стороне 1С:
+
+1. Опубликуйте информационную базу на веб-сервере (Apache или IIS) из Конфигуратора: **Администрирование → Публикация на веб-сервере**.
+2. Включите стандартный интерфейс OData у этой публикации (`enableStandardOData` / флажок OData). Путь сервиса — `/odata/standard.odata`.
+3. Заведите или выберите пользователя с правом на эту публикацию (HTTP Basic). Это логин веб-сервиса, не интерактивный сеанс Конфигуратора.
+
+Форма URL из четырёх переменных:
+
+`{ONEC_SERVER}/{ONEC_INFOBASE}/odata/standard.odata`
+
+Пример: `ONEC_SERVER=http://1c.example`, `ONEC_INFOBASE=trade` → `http://1c.example/trade/odata/standard.odata`.
+
+Публикации 8.3.5 говорят только Atom — задайте `ONEC_FORMAT=atom` (или `auto`). С 8.3.6 можно оставить JSON по умолчанию.
+
+Авторизация — HTTP Basic: `ONEC_USER` / `ONEC_PASSWORD` (или `user:pass@` внутри `ONEC_URL`). Затем добавьте JSON MCP ниже в Cursor или Claude Desktop.
+
+## Подключение (переменные окружения)
+
+| Переменная | Обязательна | Описание |
+|------------|-------------|----------|
+| `ONEC_SERVER` | Да* | Базовый URL сервера, например `http://1c.example` |
+| `ONEC_INFOBASE` | Да* | Имя публикации, например `trade` |
+| `ONEC_USER` | Да* | Пользователь OData |
+| `ONEC_PASSWORD` | Да* | Пароль OData |
+| `ONEC_URL` | Альтернатива | Один URL: `http://user:pass@host/publication` (перекрывает четыре переменные выше) |
+| `ONEC_FORMAT` | Нет | Формат ответа: `json` (по умолчанию), `atom` или `auto` |
+| `ONEC_DEBUG` | Нет | Если `true` / `1` / `yes` / `on`, HTTP-запросы пишутся в stderr |
+
+\* Задайте либо `ONEC_URL`, **либо** все четыре: `ONEC_SERVER`, `ONEC_INFOBASE`, `ONEC_USER`, `ONEC_PASSWORD`.
+
+Сервер проверяет настройки при старте и выходит с понятным сообщением в stderr, если чего-то не хватает.
+
+## Настройка MCP
+
+### Claude Desktop / Cursor
+
+```json
+{
+  "mcpServers": {
+    "1c-odata": {
+      "command": "python",
+      "args": ["-m", "python_1c_mcp.server"],
+      "env": {
+        "ONEC_SERVER": "http://1c.example",
+        "ONEC_INFOBASE": "trade",
+        "ONEC_USER": "odata_user",
+        "ONEC_PASSWORD": "secret"
+      }
+    }
+  }
+}
+```
+
+Либо консольный скрипт:
+
+```json
+{
+  "mcpServers": {
+    "1c-odata": {
+      "command": "python-1c-mcp",
+      "env": {
+        "ONEC_URL": "http://odata_user:secret@1c.example/trade"
+      }
+    }
+  }
+}
+```
+
+## Инструменты
+
+| Инструмент | Параметры | Описание |
+|------------|-----------|----------|
+| `list_entity_sets` | — | Все имена наборов из `$metadata` (обрезка после 500) |
+| `describe_entity_set` | `entity_set` | Ключи, свойства, навигация одного набора (например `Catalog_Товары`) |
+| `odata_query` | `entity_set`, `odata_filter`, `select`, `top`, `skip`, `orderby`, `inlinecount` | Запрос коллекции только на чтение. `top` по умолчанию 20, максимум 100 |
+| `get_entity` | `entity_set`, `ref_key`, `select` | Одна запись по GUID `Ref_Key` |
+| `get_metadata` | `raw_xml` | Сводка (число + примеры имён) или обрезанный XML `$metadata` |
+
+## Ресурсы
+
+| URI | Описание |
+|-----|----------|
+| `1c://entity-sets` | Текстовый список имён наборов |
+| `1c://metadata` | XML `$metadata` (обрезается, если большой) |
+
+## Чего нет
+
+| Нет | Комментарий |
+| --- | --- |
+| Инструменты записи | нет create / edit / delete / post / unpost — пакет только для чтения |
+| 8.2 / 7.7 / SOAP / COM / `/hs/` / OData 4 | вне задачи. Самая старая публикация — Atom 8.3.5 |
+
+## Разработка
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+ruff check src tests
+mypy src
+```
+
+## Лицензия
+
+MIT — Артём Гуляев

python_1c_mcp-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+python_1c_mcp/__init__.py,sha256=1j7FoDdgNyIVffC_z2uxNwkcOdUSSPo8aAS8lqb16q4,84
+python_1c_mcp/connection.py,sha256=v_AIX22EVqFxsfmVtk4Ckdj6pW7QSYE0yebS4PHViys,4142
+python_1c_mcp/entity_set.py,sha256=FVp5Lo9rG7J8dyNbdWhQ-lqdXquAiAkxTJ3eWNMfnqg,535
+python_1c_mcp/server.py,sha256=O-yaT1AuViANf1gssN0bpih0gtj5YeK0Y6xNLB-d7OY,3877
+python_1c_mcp/tools/__init__.py,sha256=xL1JPdHaZaqAo1x3XYvosiQIxyaOEWBXiIgawZUbWgY,31
+python_1c_mcp/tools/handlers.py,sha256=0mjQ2TQZB5_0m7vNcI2Aoo7ToywSSQLdRatPjH_L5M8,3842
+python_1c_mcp-0.1.0.dist-info/licenses/LICENSE,sha256=EBmfCEuDqfn65lOu87uo3uJv22P2p_XF27fgEY2CR-4,1070
+python_1c_mcp-0.1.0.dist-info/METADATA,sha256=9a1mtlByejamEhbUApZZ09eCmKpZbez4s2_0MKujQPY,14126
+python_1c_mcp-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+python_1c_mcp-0.1.0.dist-info/entry_points.txt,sha256=sWY8256hhfku4A-hpJwpeJNU1UBSLlsjfKq7k2otjfs,60
+python_1c_mcp-0.1.0.dist-info/top_level.txt,sha256=mlnenEmsL4rO7pbsDxssTCP4DVOrFRnuPgRZJ4rziq4,14
+python_1c_mcp-0.1.0.dist-info/RECORD,,

python_1c_mcp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

python_1c_mcp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+python-1c-mcp = python_1c_mcp.server:main

python_1c_mcp-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artem Gulyaev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

python_1c_mcp-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+python_1c_mcp