Alfresco Content Services

🚀 Alfresco MCP 概念実証（PoC）

このリポジトリは、Model Context ProtocolサーバーとしてAlfrescoを統合した概念実証（PoC）を含んでいます。このプロジェクトは、Alfrescoの機能をAIと組み合わせ、標準的なクライアント - サーバーアプリケーションで使用する方法を示しています。

✨ 主な機能

このPoCでは、Alfrescoの機能とAIを統合し、標準的なクライアント - サーバーアプリケーションで利用することができます。

📦 インストール

前提条件

プロジェクトを実行する前に、以下のソフトウェアがインストールされていることを確認してください。

• Docker（バージョン20.10.0以上）
• Docker Compose（バージョン1.29.0以上）
• Java Development Kit (JDK) 17以上（クライアントアプリケーション用）
• Node.js（バージョン18以上）とnpm（サーバーアプリケーション用）
• Git（リポジトリをクローンするため）

インストール手順

ステップ1：リポジトリのクローン

ローカルマシンにリポジトリをクローンします。

git clone https://github.com/aborroy/alfresco-mcp-poc.git
cd alfresco-mcp-poc

ステップ2：AlfrescoのDocker Composeの実行

alfresco/ディレクトリに移動し、Docker Composeを使用してAlfrescoのデプロイを起動します。

cd alfresco
docker-compose up --build --force-recreate

これにより、Alfrescoコンテンツサービスのスタック（リポジトリ、Share、その他必要なサービスを含む）が起動します。すべてのサービスが完全に初期化されるまで待ちます。

ステップ3：Alfrescoデプロイの検証

サービスが起動したら、以下のURLからAlfresco Shareインターフェイスにアクセスできます。

• Alfresco Share：http://localhost:8080/share
• Alfrescoリポジトリ：http://localhost:8080/alfresco デフォルトの資格情報（admin / admin）でログインします。

ステップ4：MCPクライアントの設定と実行

ローカルでOllamaサーバーを起動します。

ollama serve

alfresco-mcp-client/ディレクトリに移動し、その中のREADME.mdの指示に従ってMCPクライアントを設定して実行します。

cd ../alfresco-mcp-client
mvn clean package
java -jar target/alfresco-mcp-client-0.8.0.jar

📚 ドキュメント

プロジェクト構造

リポジトリの構造は以下の通りです。

• alfresco/：標準的なAlfrescoデプロイ用のDocker Compose設定が含まれています。MCP統合を実行する前にこの環境を起動する必要があります。
• alfresco-mcp-client/：Spring AIを使用してMCPサーバーとやり取りするJavaベースのクライアントアプリケーションです。
• alfresco-mcp-server/：TypeScript SDKを使用してMCPリクエストを処理するNode.jsベースのサーバーアプリケーションです。

カスタマイズ

alfresco/ディレクトリ内のdocker-compose.ymlファイルを変更することで、Alfrescoのデプロイをカスタマイズできます。また、MCPサーバーとクライアントコンポーネントは、特定のユースケースに合わせて構成できます。

貢献

このプロジェクトへの貢献を歓迎します！問題を開くか、プルリクエストを送信して、変更提案を提出してください。