1c-rest-mcp

aprovodka

1C:Enterprise 向け MCP サーバー — AI エージェントが、プラットフォーム独自の OData 3.0 インターフェースを通じて、稼働中の 1C データベースのデータを読み書きします。設定拡張も BSL も不要です。

34 個のツール · 11 モジュール · Node.js 18+ · stdio + Streamable HTTP

📄 製品とサービスのウェブサイト · 📖 ユーザーマニュアル（ロシア語、75 ページ） · 💬 数値照合を依頼する

npx -y @theyahia/aprovodka

---

データベーススキーマ＋数値照合 — 12,000 ₽

サーバーは無料でオープンソースです。有料なのは、お客様のデータベースに対する作業です。その要点は次のとおりです。 OData の自作実装はエラーで停止せず、誤った数値を黙って返します。 これを確認するには、具体的な構成で検証するしかありません。

情報ベース 1 件あたりの内容：

• お客様の構成に合わせたスキーマファイル — 存在するエンティティ、その名称、相互の関連を記載します。
• お客様のデータベース固有の落とし穴リスト — もっともらしく見えても誤った結果を返すクエリを記載します。
• 合意した 10 件の質問に対する照合レポート — エージェントの回答と、お客様の 1С 標準レポートの数値を、行ごとに並べて示します。

納期 — 5 営業日です。検収 — 数値の一致を基準とし、開始前に基準を合意します。 前払い 100％、NPD の領収書を発行します。条件の全文は契約約款をご覧ください。

📧 [email protected] · 💬 @metarebalancer — 営業日にモスクワ時間 10:00～19:00 に返信します。 ご利用の構成と、OData を公開しているかどうかをお知らせください。

---

できること

1C データベースの業務データは、レポート、外部データプロセッサー、またはデータ交換機能を作成するまで、外部プログラムからアクセスできません。aprovodka はその手間をなくします。プラットフォーム自体が OData 3.0 インターフェースを公開するため、それだけで十分です。

対応範囲：カタログ、ドキュメント、4 種類すべてのレジスター、仮想テーブル（残高、回転、追加次元）を含む会計レジスター、定数、一括操作、変更追跡、メタデータの検出。

同種の他の製品との違い：

• BSL 不要、構成へのインストールも不要です。 比較対象となる 8 つのサーバーのうち 6 つはデータベースへの拡張機能が必要です。不要な残りの 2 つは、稼働中のデータにアクセスしません。
• 読み取りだけでなく、書き込みにも対応します。 ドキュメントの作成と更新、転記と転記解除、削除マークに対応します。
• 書き込みの安全ゲートを備えています。 off、preview、approval の 3 つのモードがあり、クライアント内の単一箇所で処理を遮断するため、どのツールも回避できません。元に戻せる操作はロールバックトークンを返し、元に戻せない操作には理由を明記します。
• 構成別に厳選したプリセットを用意しています。БП 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/mcp-core とともにtheYahia/WWmcp モノレポにあります。このリポジトリは製品のトップページです。

@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