ROCTUP/1c-mcp-toolkit

解決する課題

1C MCP Toolkit は、AIエージェント（ClaudeやKiroなど）を1C:Enterpriseデータベースに接続する手段を提供します。複雑な構成変更、サーバー公開、COM接続の必要性を排除し、AIエージェントが1Cのデータやロジックと直接対話できるようにします。

動作の仕組み

このプロジェクトは、主に2つの動作モードを提供します。

1. 組み込みサーバー: HTTPサーバーが1C処理ファイル（.epf）内で直接実行され、ホストマシンにPythonのインストールを必要としません。
2. プロキシモード: Pythonベースのサーバー（FastAPI + MCP SDK）が仲介役として機能します。1C処理ファイルはHTTPロングポーリングを介してこのプロキシに接続し、AIエージェントはModel Context Protocol（MCP）またはREST APIを介してプロキシと通信します。

どちらのモードでも、AIエージェントはクエリの実行、任意の1Cコードの実行、メタデータやイベントログへのアクセスが可能です。

対象読者

1C:Enterpriseシステムの開発者および管理者で、データ取得、自動化、システム分析のためにAIエージェントをビジネスプロセスに統合したい方。

主な特長

• デュアルアーキテクチャ: 軽量な組み込みサーバーと、スケーラブルなDocker対応プロキシサーバーの両方をサポート。
• 包括的なツールセット: 1Cクエリの実行、BSLコードの実行、メタデータの取得、さらにはアクティブな1Cウィンドウのスクリーンショット取得（Windowsのみ）のためのツールを提供。
• データ匿名化: AIエージェントにデータを送信する前に、機密性の高い個人データや機密データを安定したトークンに置き換えてプライバシーを維持する組み込みサポート。
• 柔軟な統合: ネイティブなAIエージェント統合のためのModel Context Protocol（MCP）と、MCPをサポートしないエージェント向けの標準REST APIに対応。
• 幅広い互換性: 1C:Enterpriseバージョン8.2.13以降および8.3.25で動作。