Spring MCP 1c Copilot

🚀 Spring Boot MCP Server for 1С:Assistant

このSpring Boot MCP Serverは、1С:Assistant APIとの統合を目的とした、完全機能を備えたMCP（Model Context Protocol）サーバーです。APIを通じて、AIアシスタントとの円滑なやり取りを実現します。

📄 ライセンス: 個人および非営利目的での使用はオープンソースです。商用利用については、作者の許可が必要です。

✨ 主な機能

• 🎯 MCPプロトコルサポート: AIアシスタントとの統合に必要なMCPプロトコルを完全にサポートします。
• 🤖 1С:Assistant統合: 適切なエンドポイントを介して、1С:Assistant APIと直接統合します。
• ⚡ SSEサポート: リアルタイム通信のためのServer-Sent Eventsをサポートします。
• 🌐 REST API: 直接的なやり取りのための追加のRESTエンドポイントを提供します。
• 📚 Swagger UI: APIのインタラクティブなドキュメントを提供します。
• 🐳 Docker対応: デプロイ用のDocker構成が用意されています。
• 🔐 認証: 1С:Assistant API用のBearerトークンをサポートします。

🛠️ MCPツール

1. ask_1c_ai

1С:AssistantのAIに質問を投げかけます。

• question (必須): AIに対する質問
• programming_language (オプション): プログラミング言語
• create_new_session (オプション): 新しいセッションを作成する

2. explain_1c_syntax

1Сの構文要素を説明します。

• syntax_element (必須): 説明する構文要素
• context (オプション): 使用コンテキスト

3. check_1c_code

1Сのコードのエラーをチェックします。

• code (必須): チェックする1Сのコード
• check_type (オプション): チェックのタイプ (syntax, logic, performance)

🚀 クイックスタート

必要条件

• Java 17以上
• Docker（推奨）
• 1С:Assistant APIへのアクセストークン

1. 1С:Assistantのトークン取得

1. code.1c.aiに登録します。
2. マイページでアクセストークンを取得します。
3. トークンを環境変数で使用できるように保存します。

2. ローカルでの起動

# リポジトリをクローンします
git clone <repository-url>
cd spring-mcp-1c-copilot

# 環境変数を設定します
export ONEC_AI_TOKEN="your_token_here"
export ONEC_AI_BASE_URL="https://code.1c.ai"

# アプリケーションを起動します
./gradlew bootRun

3. Dockerでの起動（推奨）

# イメージをビルドします
docker build -f Dockerfile.build -t spring-mcp-1c-copilot .

# コンテナを起動します
docker run -d --name spring-mcp-1c-copilot -p 8000:8000 \
  -e ONEC_AI_TOKEN="your_token_here" \
  spring-mcp-1c-copilot

📡 APIエンドポイント

MCPエンドポイント

• POST /mcp - JSON-RPCリクエスト用の主要なMCPエンドポイント
• GET /mcp - MCPクライアント用のSSEストリーム

REST APIエンドポイント

• POST /api/ask-ai - 1С:AssistantのAIに質問を投げかけます。
• POST /api/explain-syntax - 1Сの構文を説明します。
• POST /api/check-code - 1Сのコードのエラーをチェックします。
• GET /api/health - サーバーの状態を確認します。

ドキュメント

• http://localhost:8000/swagger-ui.html - Swagger UIのドキュメント
• http://localhost:8000/api-docs - OpenAPIのJSONスキーマ

⚙️ 設定

環境変数

application.yml

onec:
  ai:
    token: ${ONEC_AI_TOKEN:}
    base-url: ${ONEC_AI_BASE_URL:https://code.1c.ai}
    timeout: ${ONEC_AI_TIMEOUT:30}

server:
  port: ${SSE_PORT:8000}

springdoc:
  api-docs:
    path: /api-docs
  swagger-ui:
    path: /swagger-ui.html
    enabled: true

🔗 Cursor IDEとの統合

~/.cursor/mcp.jsonに以下を追加します。

{
  "servers": {
    "1c-copilot-proxy": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

これで、Cursor IDEで1С:Assistantを使用するためのすべてのツールが利用可能になります！

🏗️ プロジェクト構造

src/main/kotlin/ru/alkoleft/copilot/
├── McpCopilotApplication.kt          # アプリケーションのメインクラス
├── config/
│   ├── McpConfiguration.kt           # MCPの設定
│   └── OpenApiConfig.kt              # Swaggerの設定
├── controller/
│   ├── McpController.kt              # MCPコントローラー
│   └── RestApiController.kt          # REST APIコントローラー
└── service/
    ├── OneCApiClient.kt              # 1С:Assistant API用のクライアント
    └── OneCCopilotService.kt         # MCPツールを持つサービス

🧪 テスト

MCP初期化のテスト

curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {"tools": true}
    }
  }'

REST APIのテスト

curl -X POST "http://localhost:8000/api/ask-ai?question=1Сで参照データを作成するにはどうすればいいですか？"

🔧 開発

ビルド

./gradlew build

テストの実行

./gradlew test

ローカル開発

./gradlew bootRun --args='--spring.profiles.active=dev'

📋 ログとデバッグ

Dockerコンテナのログを表示

docker logs spring-mcp-1c-copilot --follow

ログレベル

• DEBUG - 開発用の詳細なログ
• INFO - 主なイベント（デフォルト）
• WARN - 警告
• ERROR - エラー

🚀 本番環境でのデプロイ

サーバーへのデプロイの詳細なガイドについては、DEPLOYMENT.mdを参照してください。

🙏 謝辞

このプロジェクトは、以下のリポジトリの成果に基づいています。

• artesk/1copilot_MCP - Pythonでの1С:Assistant用のオリジナルMCPサーバー
• rentgengl/copilot-1c-proxy - 1С:Assistantへのリクエスト用のプロキシサーバー

これらのプロジェクトの作者の皆様に心から感謝申し上げます！🎉

当社のSpring Boot MCP Serverは、これらのプロジェクトのアイデアを発展させ、以下の機能を追加しています。

• Spring BootとKotlinによる最新のアーキテクチャ
• SSEを備えたMCPプロトコルの完全サポート
• Swagger UIによるドキュメント
• 本番環境用の構成
• デプロイの自動化

🤝 コントリビューション

1. リポジトリをフォークします。
2. フィーチャーブランチを作成します (git checkout -b feature/amazing-feature)
3. 変更をコミットします (git commit -m 'Add amazing feature')
4. ブランチにプッシュします (git push origin feature/amazing-feature)
5. プルリクエストを作成します。

📄 ライセンス

ライセンス: オープンソース（個人および非営利目的での使用）

• ✅ 個人使用 - 自由に利用可能
• ✅ 非営利目的の使用 - 自由に利用可能
• ✅ 教育目的 - 自由に利用可能
• ❌ 商用利用 - 作者の許可が必要

商用利用の許可を得るには、作者に連絡してください。

参考プロジェクト:

• artesk/1copilot_MCP - Unlicense
• rentgengl/copilot-1c-proxy - MIT License

🆘 サポート

問題が発生した場合は、以下の手順を試してください。

1. Issuesを確認します。
2. 1С:Assistantのトークンが有効であることを確認します。
3. コンテナのログを確認します: docker logs spring-mcp-1c-copilot
4. 問題の詳細を記載した新しいIssueを作成します。

🎉 MCPを通じて1С:Assistantの使用を楽しんでください！