Skip to Content
DistributionMCP Server (Python)

FrootAI

FrootAI

MCP Server (Python)

From the Roots to the Fruits. It’s simply Frootful.

An open ecosystem where Infra, Platform, and App teams build AI β€” Frootfully.

A uniFAIng glue for the GenAI ecosystem, enabling deterministic and reliable AI solutions.

PyPIdownloadslicense


The Philosophy Behind FrootAI β€” The Essence of the FAI Engine

FrootAI is an intelligent way of packaging skills, knowledge, and the essential components of the GenAI ecosystem β€” all synced, not standalone. Infrastructure, platform, and application layers are woven together so that every piece understands and builds on the others. That’s what β€œfrom the roots to the fruits” means: a fully connected ecosystem where Infra, Platform, and App teams build AI β€” Frootfully.

The FROOT Framework


FROOT = Foundations Β· Reasoning Β· Orchestration Β· Operations Β· Transformation

LayerWhat You Learn
FTokens, models, glossary, Agentic OS
RPrompts, RAG, grounding, deterministic AI
OSemantic Kernel, agents, MCP, tools
OAzure AI Foundry, GPU infra, Copilot ecosystem
TFine-tuning, responsible AI, production patterns

The FAI Ecosystem

FAI Ecosystem β€” Factory builds, Packages deliver, Toolkit equips


Quick Start

Requirements: Python >= 3.10

pip install frootai-mcp

Run as MCP Server

frootai-mcp-py

Use in Python

from frootai_mcp.server import mcp # Run as MCP server (stdio transport) mcp.run(transport="stdio")

Or call tools directly:

import asyncio from frootai_mcp.server import search_knowledge, wire_play result = asyncio.run(search_knowledge(query="RAG architecture")) print(result)

Connect to Your Agent

VS Code / GitHub Copilot .vscode/mcp.json:

{ "servers": { "frootai": { "type": "stdio", "command": "frootai-mcp-py" } } }

Claude Desktop / Cursor

{ "mcpServers": { "frootai": { "command": "frootai-mcp-py" } } }

MCP Capabilities

CapabilityCountDescription
Tools45Full MCP tools with annotations
Resources4URI templates for modules, plays, glossary, overview
Prompts6Guided workflows for architecture, review, scaffold
SearchBM25358 docs Γ— 8,627 terms, Robertson IDF
Plays100Solution architectures from starter to enterprise
PrimitivesGrowingAgents, instructions, skills, hooks, plugins

MCP Tools (45)

Knowledge (6) β€” bundled knowledge, works offline

  • list_modules β€” browse FROOT knowledge modules by layer
  • get_module β€” read any module in full
  • lookup_term β€” AI/ML glossary lookup (comprehensive glossary)
  • search_knowledge β€” BM25 full-text search across all modules
  • get_architecture_pattern β€” architecture decision guides
  • get_froot_overview β€” complete framework summary

Solution Plays (5) β€” 100 pre-architected solutions

  • list_solution_plays β€” list all 100 plays with filters
  • get_play_detail β€” full play info with infra, tuning, complexity
  • semantic_search_plays β€” BM25-powered play matching
  • compare_plays β€” side-by-side play comparison
  • generate_architecture_diagram β€” Mermaid.js diagrams

Agent Chain (3) β€” build β†’ review β†’ tune

  • agent_build β€” architecture guidance + recommended play
  • agent_review β€” security, quality, compliance audit
  • agent_tune β€” production readiness + tuning recommendations

Azure / Live (4) β€” Azure AI intelligence

  • get_model_catalog β€” model catalog with pricing tiers
  • get_azure_pricing β€” service pricing by tier
  • compare_models β€” side-by-side model comparison
  • estimate_cost β€” itemized monthly cost per play

Ecosystem (5) β€” platform awareness

  • get_github_agentic_os β€” .github Agentic OS guide
  • list_community_plays β€” community plugin marketplace
  • fetch_azure_docs β€” Azure documentation links
  • fetch_external_mcp β€” discover MCP servers
  • get_play_spec β€” SpecKit with WAF alignment

FAI Engine (5) β€” protocol wiring

  • wire_play β€” generate fai-manifest.json for a play
  • inspect_wiring β€” check what primitives are connected
  • validate_manifest β€” validate fai-manifest.json schema
  • validate_config β€” validate AI config parameters
  • evaluate_quality β€” run quality evaluation (groundedness, relevance, etc.)

Marketplace (4) β€” primitive discovery

  • list_marketplace β€” browse AI primitives by type
  • get_primitive_detail β€” get detail for a specific primitive
  • search_marketplace β€” keyword search across all primitives
  • embedding_playground β€” text similarity comparison (educational)

Scaffold (5) β€” project bootstrapping

  • scaffold_play β€” scaffold a new play with DevKit structure
  • smart_scaffold β€” describe what you want, get the best play
  • list_templates β€” available scaffold templates by complexity
  • preview_scaffold β€” dry-run preview of scaffold output
  • scaffold_status β€” check scaffold completeness

Extra (8) β€” specialized utilities

  • run_evaluation β€” run evaluation with custom thresholds
  • get_bicep_best_practices β€” Bicep IaC best practices
  • list_primitives β€” list primitives by type
  • get_waf_guidance β€” WAF pillar guidance
  • check_play_compatibility β€” check if plays can compose
  • get_learning_path β€” curated learning paths by topic
  • export_play_config β€” export play config as JSON
  • get_version_info β€” server version and capabilities

MCP Resources (4)

URIDescription
fai://modules/{module_id}Read FROOT module without tool call
fai://plays/{play_id}Read solution play without tool call
fai://glossary/{term}Look up glossary term without tool call
fai://overviewPlatform overview without tool call

MCP Prompts (6)

PromptDescription
design_architectureGuided AI architecture design
review_configStructured config review for production
pick_solution_playConversational play selection
estimate_costsAzure cost estimation workflow
scaffold_projectProject bootstrapping workflow
learn_fai_protocolFAI Protocol educational walkthrough

What Ships Inside

ComponentDetails
FROOT KnowledgeKnowledge modules across 5 layers (682KB)
BM25 Search Index358 documents Γ— 8,627 terms, pre-computed IDF
Solution Plays100 pre-architected Azure AI solutions
AI GlossaryComprehensive glossary extracted from modules
FAI ProtocolManifest schema for play wiring
Architecture GuidesRAG, agents, hosting, cost, security

Feature parity with the Node.js MCP server β€” same MCP tools, same knowledge, same FAI Engine.


Testing

pip install pytest cd python-mcp python -m pytest tests/ -v # 43 tests across 9 test classes

ResourceLink
Websitefrootai.devΒ 
Setup GuideFAI Packages SetupΒ 
Python SDKPyPI β€” frootaiΒ 
Node MCP Servernpm β€” frootai-mcpΒ 
VS Code ExtensionMarketplaceΒ 
Docker ImageGitHub Container RegistryΒ 
GitHubfrootai/frootaiΒ 
Contact[email protected]

Β© 2026 FrootAI β€” MIT License

AI architecture Β· MCP Β· model-context-protocol Β· Python Β· Azure Β· RAG Β· agents Β· copilot Β· semantic-kernel Β· open-source Β· frootai

Last updated on