vladimir-kharin/1c_mcp

Инструмент для создания MCP-серверов в 1С:Предприятие путем разработки расширения конфигурации. Позволяет интегрировать данные и функциональность 1С с AI-ассистентами (Claude, Cursor и т.д.). Включает Python-прокси и пример расширения 1С с готовыми инструментами.

何であるか

vladimir-kharin/1c_mcp は、ロシアのERPプラットフォーム 1С:Предприятие の開発者向けに、大規模言語モデル（LLM）にデータとビジネスロジックを Model Context Protocol (MCP) を通じて公開できるオープンソースツールキットです。事前構築済みの1C拡張と、認証処理、トランスポート変換、DockerデプロイをサポートするオプションのPythonプロキシを提供しています。

なぜ重要か

LLM（ChatGPT、Claude、Cursorなど）は、最新でドメイン特化された情報をクエリできる場合に最も効果的に機能します。MCPは、実行時にランタイムでツールを発見し、そのツールを通じてデータを要求できるようになる、登場間もないオープンスタンダードです。このプロジェクトは、1Cの独自データモデルとこのプロトコルの間のギャップを埋め、MCP互換のAIクライアントが1Cベースの知識を利用可能にします。

コアコンポーネント

コンポーネント	機能	言語 / ランタイム
`src/1c_ext/`	MCP HTTPサービスを実装する1C拡張（`MCP_Сервер.cfe`）、ツールコンテナの登録、1Cメタデータとの連携に役立つヘルパー関数を提供します。	1C（BSL）
`src/py_server/`	AIクライアントと1C HTTPサービスの間に配置されるオプションのPythonプロキシ。OAuth2サポートを追加し、ユーザーごとのBasic Authを転送可能。また、`stdio`ベースのトランスポートをHTTPに変換します。	Python（Docker対応）

クイックスタート（概要）

1C拡張のインストール – コンパイル済みの build/MCP_Сервер.cfe を1C構成にコピーし、HTTPサービス mcp_APIBackend を公開します。
サービスの公開 – URLに正確なデータベース名（大文字小文字区別）を含めるようにし、POSTリクエストが壊れるリダイレクトを回避します。
AIクライアントの接続 – Cursor、Claude Desktop、または任意のMCP互換ツールを …/your_db/hs/mcp/ に接続します。サンプルクライアント設定は mcp_client_settings/ にあります。
(推奨) Pythonプロキシの実行 – src/py_server/ のREADMEに従うか、Dockerで起動（docker-compose up -d）。プロキシはOAuth2を処理し、各ユーザーの資格情報を転送できるため、1Cの認証を無効化する必要がありません。

自分の機能を追加する方法

新しい1C処理を作成し、サブシステム mcp_КонтейнерыИнструментов に追加します。

2つのエクスポートメソッドを実装します：

Процедура ДобавитьИнструменты(Инструменты) Экспорт
    // ツール名、パラメータなどを記述
КонецПроцедуры

Функция ВыполнитьИнструмент(ИмяИнструмента, Аргументы) Экспорт
    // LLMが呼び出す実際のビジネスロジック
КонецФункции

または、独自の1C拡張にツールをパッケージ化し、*_mcp_MCPСервер という名前のサブシステムを含める。サーバーは自動で発見します。
src/1c_ext/agents.md のガイドを使用してAPIの詳細を確認し、オプションで Resources（静的ファイル）や Prompts（テンプレートメッセージ）を公開できます。

一般的な利用例

AI支援ERPサポート – チャットアシスタントがモデルに顧客の注文履歴を取得、税額を計算、または即座に新しい請求書を作成するよう依頼できます。
コード生成支援 – LLMが1Cからスキーマ情報を取得し、正しいBSLスニペットを生成できます。
ビジネスインテリジェンス – エージェントが集計されたメトリクスを取得し、カスタムレポートを実行、またはMCPツール経由でバックグラウンドジョブをトリガーできます。

ドキュメントとリソース

Pythonプロキシ: src/py_server/README.md
1C拡張の詳細: src/1c_ext/README.md
ツール開発ガイド: src/1c_ext/agents.md
サンプルクライアント設定: mcp_client_settings/
ビデオ概要: README内のVK、YouTube、Rutubeリンク

ライセンス

MIT – コードを自由に使用、変更、再配布できます。

TL;DR: このリポジトリは1C用の事前構築済みMCPサーバーとPythonプロキシを提供し、MCP互換のLLMクライアントがカスタム1Cツールを呼び出し、企業データを自動で取得できるようにします。これは、主流のロシアERPシステムと現代のAIアシスタントの間の具体的な橋渡しです。