Alfresco MCP Server

#!/usr/bin/env python3 """ Quick Start Example for Alfresco MCP Server This example demonstrates: - Basic server connection - Making your first tool call - Handling responses - Simple error handling Prerequisites: - Alfresco MCP Server running - Environment variables set (ALFRESCO_URL, ALFRESCO_USERNAME, ALFRESCO_PASSWORD) """ import asyncio import os from fastmcp import Client from alfresco_mcp_server.fastmcp_server import mcp async def quick_start_example(): """Quick start example showing basic MCP server usage.""" print("🚀 Alfresco MCP Server - Quick Start Example") print("=" * 50) # Check environment setup print("\n📋 Checking Environment Setup...") required_vars = ["ALFRESCO_URL", "ALFRESCO_USERNAME", "ALFRESCO_PASSWORD"] for var in required_vars: value = os.getenv(var) if value: print(f"✅ {var}: {value}") else: print(f"❌ {var}: Not set (using defaults)") try: # Connect to the MCP server print("\n🔌 Connecting to MCP Server...") async with Client(mcp) as client: print("✅ Connected successfully!") # List available tools print("\n🛠️ Available Tools:") tools = await client.list_tools() for i, tool in enumerate(tools, 1): print(f" {i:2d}. {tool.name} - {tool.description}") # List available resources print("\n📚 Available Resources:") resources = await client.list_resources() for i, resource in enumerate(resources, 1): print(f" {i:2d}. {resource.uri}") # List available prompts print("\n💭 Available Prompts:") prompts = await client.list_prompts() for i, prompt in enumerate(prompts, 1): print(f" {i:2d}. {prompt.name} - {prompt.description}") # Example 1: Simple search print("\n🔍 Example 1: Simple Document Search") print("-" * 40) search_result = await client.call_tool("search_content", { "query": "*", # Search for all documents "max_results": 5 }) if search_result: print("Search Result:") print(search_result[0].text) # Example 2: Get repository info print("\n📊 Example 2: Repository Information") print("-" * 40) repo_info = await client.read_resource("alfresco://repository/info") if repo_info: print("Repository Info:") print(repo_info[0].text) # Example 3: Create a test folder print("\n📁 Example 3: Create Test Folder") print("-" * 40) folder_result = await client.call_tool("create_folder", { "folder_name": f"MCP_Test_Folder_{asyncio.current_task().get_name()}", "parent_id": "-root-", "description": "Test folder created by MCP Quick Start example" }) if folder_result: print("Folder Creation Result:") print(folder_result[0].text) # Example 4: Get analysis prompt print("\n💡 Example 4: Analysis Prompt") print("-" * 40) prompt_result = await client.get_prompt("search_and_analyze", { "query": "financial reports", "analysis_type": "summary" }) if prompt_result.messages: print("Generated Prompt:") print(prompt_result.messages[0].content.text[:300] + "...") print("\n✅ Quick Start Complete!") print("Next steps:") print("- Explore other examples in this directory") print("- Check the documentation in ../docs/") print("- Try the document lifecycle example") except Exception as e: print(f"\n❌ Error: {e}") print("\nTroubleshooting:") print("1. Ensure Alfresco server is running") print("2. Check environment variables") print("3. Verify network connectivity") return False return True def main(): """Main function to run the quick start example.""" print("Starting Alfresco MCP Server Quick Start Example...") # Run the async example success = asyncio.run(quick_start_example()) if success: print("\n🎉 Example completed successfully!") else: print("\n💥 Example failed. Please check the error messages above.") if __name__ == "__main__": main()