mcpField
1
1c-rest-mcp

1c-rest-mcp

本地服务
github.com商业与营销128 周前更新
代码仓库访问官网

关于 1c-rest-mcp

aprovodka 是面向 1C:Enterprise 数据库的 MCP 服务，通过平台提供的 OData 3.0 接口读写业务数据，无需安装配置扩展或编写 BSL。适合需要让 AI Agent 查询和维护 1C 数据的团队，并提供写入安全门控及常见配置预设。

主要功能

  1. 01读取目录、单据和各类寄存器
  2. 02创建、更新、过账及取消过账单据
  3. 03通过 OData 3.0 访问数据
  4. 04支持写入预览与审批门控
  5. 05提供常见 1C 配置预设

适用场景

  1. 01让 Agent 查询 1C 业务数据
  2. 02创建或更新 1C 单据
  3. 03在执行写入前预览或审批操作

MCP 相关

作为 MCP 服务，它向客户端提供 1C 数据读取、写入、批处理、变更跟踪和元数据发现工具；支持 stdio 与 Streamable HTTP。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "theyahia-1c-rest": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/1c-rest-mcp"
      ]
    }
  }
}
启动命令npx -y @theyahia/1c-rest-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@theyahia/1c-rest-mcp1.2.1

工具

9

收录的工具列表 · 更新于 2 周前

参数类型必填说明
typeenum否按类型筛选：all — 所有实体，catalogs — 目录（Catalog_*），documents — 文档（Document_*），registers — 寄存器（AccumulationRegister_*、InformationRegister_*），reports — 报表（Report_*）all | catalogs | documents | registers | reports
searchstring否用于搜索实体名称的子字符串（例如，'Номенклатура'）

详细介绍

aprovodka

适用于 1C:Enterprise 的 MCP 服务——AI Agent 通过平台自身的 OData 3.0 接口读取和写入实时 1C 数据库数据。无需配置扩展，无需 BSL。

npm License: MIT

34 个工具 · 11 个模块 · Node.js 18+ · stdio + Streamable HTTP

📄 产品网站与服务 · 📖 用户手册（俄文，75 页） · 💬 订购数字核对

npx -y @theyahia/aprovodka

数据库架构 + 数字核对 — 12 000 ₽

服务免费且开源。收费的是针对您数据库的工作，因为一切都取决于一件事： 基于 OData 自行开发的程序不会崩溃，而是会悄悄返回错误数字。 只有针对具体配置才能验证这一点。

每个信息数据库的服务内容：

  • 适用于您配置的架构文件——有哪些实体、它们叫什么、彼此如何关联；
  • 针对您数据库的陷阱清单——哪些查询会返回看似合理、实则错误的结果；
  • 针对 10 个约定问题的核对报告——Agent 的回答与您自己的 1C 标准报表中的数字并列，逐行对照。

周期——5 个工作日。验收——以数字一致为准，验收标准在开始前约定。 预付 100%，提供 NPD 收据。完整条款见服务要约合同。

📧 [email protected] · 💬 @metarebalancer——我们会在工作日 10:00–19:00（莫斯科时间）回复。 请告知您使用的配置，以及是否已发布 OData。

功能

在有人为其编写报表、外部数据处理器或数据交换之前，外部程序无法访问 1C 数据库中的业务数据。aprovodka 消除了这一流程：平台自身发布的 OData 3.0 接口就已足够。

支持范围：目录、单据、全部四种寄存器、包含虚拟表（余额、周转额、扩展维度）的会计寄存器、常量、批量操作、变更跟踪和元数据发现。

与同类工具相比的特点：

  • 无需 BSL，无需向配置中安装任何内容。 八个可比服务中，有六个要求在数据库中安装扩展；另外两个虽然不需要，却无法操作实时数据。
  • 不止读取，还能写入。 创建和更新单据、过账和取消过账、删除标记。
  • 写入安全闸门。 提供 off、preview、approval 三种模式；在客户端的单一位置拦截，任何工具都无法绕过。可撤销操作会返回回滚令牌；不可撤销操作会标明原因。
  • 精选配置预设，适用于 БП 3.0、УТ 11、ЗУП 3.1 和 ERP 2，包含带俄文说明的关键实体、可直接使用的查询示例，以及常见陷阱。

配置

{
  "mcpServers": {
    "aprovodka": {
      "command": "npx",
      "args": ["-y", "@theyahia/aprovodka"],
      "env": {
        "ONEC_BASE_URL": "https://server/base/odata/standard.odata",
        "ONEC_LOGIN": "user",
        "ONEC_PASSWORD": "pass"
      }
    }
  }
}

将 ONEC_WRITE_MODE 设为 preview 或 approval 即可启用写入闸门（默认值为 off，行为与之前完全一致）。完整的环境变量参考、逐工具文档和模块筛选器，见单体仓库 README。

代码所在位置

源代码、测试和发布版本均位于 theYahia/WWmcp 单体仓库中，与共享的 @theyahia/mcp-core 一同维护。本仓库是产品的首页。

从 @theyahia/1c-rest-mcp 迁移

该软件包在 v4.0.0 中更名了——产品名称中不得使用「1С」（Infostart 规则第 2.2.11 条）。旧软件包已停留在 v3.2.0。

  • 安装： npx -y @theyahia/aprovodka
  • 二进制文件已更名： 1c-rest-mcp → aprovodka
  • MCP 握手中的服务名称现在是 aprovodka——如果你固定了该名称，请更新对应的键

其他内容均未改变：工具名称、参数、返回格式、提示词以及 ONEC_* 环境变量（1C_* 别名仍然有效）。除了命令之外，无需更改配置。

商标

aprovodka 是一款独立产品，并非 1C Company 的产品，也与其无关联。「1С」和「1С:Предприятие」是 1C Company 的商标；本产品名称不含这些商标。与数据库的交互仅通过平台自身提供的开放 OData 接口进行。

许可证

MIT

Telegram： @vhodvai

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。