fast-agent-mcp 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

{fast_agent_mcp-0.2.0.dist-info → fast_agent_mcp-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.2.0
+Version: 0.2.1
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>, Sarmad Qadri <sarmad@lastmileai.dev>
 License:                                  Apache License

{fast_agent_mcp-0.2.0.dist-info → fast_agent_mcp-0.2.1.dist-info}/RECORD

@@ -22,7 +22,7 @@ mcp_agent/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/cli/__main__.py,sha256=AVZ7tQFhU_sDOGuUGJq8ujgKtcxsYJBJwHbVaaiRDlI,166
 mcp_agent/cli/main.py,sha256=oumTbJPbiLFomm5IcdKJNjP3kXVkeYTxZEtYTkBBfLA,2742
 mcp_agent/cli/terminal.py,sha256=GRwD-RGW7saIz2IOWZn5vD6JjiArscELBThm1GTFkuI,1065
-mcp_agent/cli/commands/bootstrap.py,sha256=Dm_Fy8UhvLHCkSfV5e8G6NV5JiQrFPJqAfVPshr_-kY,10651
+mcp_agent/cli/commands/bootstrap.py,sha256=Pv3LQUQLK_5-8nbOQ6iibJI7awgD04P9xh6-VpU15pw,11571
 mcp_agent/cli/commands/config.py,sha256=jU2gl4d5YESrdUboh3u6mxf7CxVT-_DT_sK8Vuh3ajw,231
 mcp_agent/cli/commands/setup.py,sha256=iXsKrf31Szv4Umbk9JfR5as9HcivFJchhE1KKzHxyIo,6345
 mcp_agent/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -101,6 +101,10 @@ mcp_agent/mcp/prompts/prompt_server.py,sha256=tXtQd4EnH86MmdAvHlXm4oOS1dWLSCW5Pv
 mcp_agent/mcp/prompts/prompt_template.py,sha256=EejiqGkau8OizORNyKTUwUjrPof5V-hH1H_MBQoQfXw,15732
 mcp_agent/mcp_server/__init__.py,sha256=zBU51ITHIEPScd9nRafnhEddsWqXRPAAvHhkrbRI2_4,155
 mcp_agent/mcp_server/agent_server.py,sha256=I3jh2izfiUSQFZzboEavtp8DJpkx3tuaeLqRReOTuiM,4491
+mcp_agent/resources/examples/data-analysis/analysis-campaign.py,sha256=QdNdo0-7LR4Uzw61hEU_jVKmWyk6A9YpGo81kMwVobM,7267
+mcp_agent/resources/examples/data-analysis/analysis.py,sha256=M9z8Q4YC5OGuqSa5uefYmmfmctqMn-WqCSfg5LI407o,2609
+mcp_agent/resources/examples/data-analysis/fastagent.config.yaml,sha256=ini94PHyJCfgpjcjHKMMbGuHs6LIj46F1NwY0ll5HVk,1609
+mcp_agent/resources/examples/data-analysis/mount-point/WA_Fn-UseC_-HR-Employee-Attrition.csv,sha256=pcMeOL1_r8m8MziE6xgbBrQbjl5Ijo98yycZn7O-dlk,227977
 mcp_agent/resources/examples/in_dev/agent_build.py,sha256=eetMEdYDbmnRH4CLO7chpQucAar3OE7iVzD_pnMjIGs,2854
 mcp_agent/resources/examples/in_dev/slides.py,sha256=-SEFeGIg9SLF253NIxmA0NjlanLe8CR1yjDBBp2LXgs,4904
 mcp_agent/resources/examples/internal/agent.py,sha256=RZOMb5cJzIY1k0V28YgrHcUFSt0Uy977towy4yJE7bA,502
@@ -115,9 +119,20 @@ mcp_agent/resources/examples/prompting/agent.py,sha256=yuONn6xkQfk6hjanC9j5_zsIK
 mcp_agent/resources/examples/prompting/fastagent.config.yaml,sha256=UR6LtCpeSIzkHsCrHJW1z-wE7AgmgKozS_IYcfcSAkc,1270
 mcp_agent/resources/examples/prompting/image_server.py,sha256=vRDRGi68BqTWcldZ4-sd8j41M3e5TtWIUSzIROK8uFo,1667
 mcp_agent/resources/examples/prompting/work_with_image.py,sha256=2MctSPXZsmIyCYvsxsRc1_v_8v0ZKorHH0gWZxLW8Tc,507
+mcp_agent/resources/examples/researcher/fastagent.config.yaml,sha256=bNOnID9OgdSBTUEhdimKB8LjaZLa1B6igmp-nxx8nr4,2271
+mcp_agent/resources/examples/researcher/researcher-eval.py,sha256=CR9m4lyoXijS1whvsBDuk6IA-RmNc6iOYbtloETkITY,1833
+mcp_agent/resources/examples/researcher/researcher-imp.py,sha256=oJxSVnLbZfIn71QbQR1E6j_m_UBrOOGP4SVljXErHLQ,7879
+mcp_agent/resources/examples/researcher/researcher.py,sha256=SZfExi-FfwYETzGt2O3caS3L5E6EemV3IUrJHyzZqHI,1333
+mcp_agent/resources/examples/workflows/chaining.py,sha256=tY0kA0U8s2rceAO4ogZFtpQEkiUWcrYnYDgHu_-4G50,889
+mcp_agent/resources/examples/workflows/evaluator.py,sha256=cQJCHLqzmzUZwrJoAYLpZv_C_LG26kAUWh3dKQPXtJA,3095
+mcp_agent/resources/examples/workflows/fastagent.config.yaml,sha256=k2AiapOcK42uqG2nWDVvnSLqN4okQIQZK0FTbZufBpY,809
+mcp_agent/resources/examples/workflows/human_input.py,sha256=_I6nS6xYo8IHAmvzsUYOxqVGb4G6BTyJXPAmS3fNcBU,621
+mcp_agent/resources/examples/workflows/orchestrator.py,sha256=rOGilFTliWWnZ3Jx5wZOH6AQMBKwaGqSMI4PR9MKcZw,2507
+mcp_agent/resources/examples/workflows/parallel.py,sha256=n0dFN26QvYd2wjgohcaUBflac2SzXYx-bCyxMSousJE,1884
+mcp_agent/resources/examples/workflows/router.py,sha256=E4x_-c3l4YW9w1i4ARcDtkdeqIdbWEGfsMzwLYpdbVc,1677
 mcp_agent/ui/console_display.py,sha256=TVGDtJ37hc6UG0ei9g7ZPZZfFNeS1MYozt-Mx8HsPCk,9752
-fast_agent_mcp-0.2.0.dist-info/METADATA,sha256=nN7ojDC04t2YuU51qVbESNSNXuECopH6f5BxhmH2ghI,29647
-fast_agent_mcp-0.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fast_agent_mcp-0.2.0.dist-info/entry_points.txt,sha256=qPM7vwtN1_KmP3dXehxgiCxUBHtqP7yfenZigztvY-w,226
-fast_agent_mcp-0.2.0.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
-fast_agent_mcp-0.2.0.dist-info/RECORD,,
+fast_agent_mcp-0.2.1.dist-info/METADATA,sha256=aewQmossBC95xw0NPet8u2LUxcjqRdsjdU291wudXsY,29647
+fast_agent_mcp-0.2.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fast_agent_mcp-0.2.1.dist-info/entry_points.txt,sha256=qPM7vwtN1_KmP3dXehxgiCxUBHtqP7yfenZigztvY-w,226
+fast_agent_mcp-0.2.1.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
+fast_agent_mcp-0.2.1.dist-info/RECORD,,

mcp_agent/cli/commands/bootstrap.py

@@ -20,7 +20,6 @@ EXAMPLE_TYPES = {
         "'Building Effective Agents' paper. Some agents use the 'fetch'\n"
         "and filesystem MCP Servers.",
         "files": [
-            "agent_build.py",
             "chaining.py",
             "evaluator.py",
             "human_input.py",
@@ -70,9 +69,33 @@ def copy_example_files(example_type: str, target_dir: Path, force: bool = False)
             mount_point_dir.mkdir(parents=True)
             console.print(f"Created mount-point directory: {mount_point_dir}")
 
-    # Use examples from top-level directory
-    package_dir = Path(__file__).parent.parent.parent.parent.parent
-    source_dir = package_dir / "examples" / ("workflows" if example_type == "workflow" else f"{example_type}")
+    # Try to use examples from the installed package first, or fall back to the top-level directory
+    from importlib.resources import files
+
+    try:
+        # First try to find examples in the package resources
+        source_dir = (
+            files("mcp_agent")
+            .joinpath("resources")
+            .joinpath("examples")
+            .joinpath("workflows" if example_type == "workflow" else f"{example_type}")
+        )
+        if not source_dir.is_dir():
+            # Fall back to the top-level directory for development mode
+            package_dir = Path(__file__).parent.parent.parent.parent.parent
+            source_dir = (
+                package_dir
+                / "examples"
+                / ("workflows" if example_type == "workflow" else f"{example_type}")
+            )
+    except (ImportError, ModuleNotFoundError, ValueError):
+        # Fall back to the top-level directory if the resource finding fails
+        package_dir = Path(__file__).parent.parent.parent.parent.parent
+        source_dir = (
+            package_dir
+            / "examples"
+            / ("workflows" if example_type == "workflow" else f"{example_type}")
+        )
 
     if not source_dir.exists():
         console.print(f"[red]Error: Source directory not found: {source_dir}[/red]")

mcp_agent/resources/examples/data-analysis/analysis-campaign.py

@@ -0,0 +1,188 @@
+import asyncio
+
+from mcp_agent.core.fastagent import FastAgent
+from mcp_agent.llm.augmented_llm import RequestParams
+
+# Create the application
+fast = FastAgent("Data Analysis & Campaign Generator")
+
+
+# Original data analysis components
+@fast.agent(
+    name="data_analysis",
+    instruction="""
+You have access to a Python 3.12 interpreter and you can use this to analyse and process data. 
+Common analysis packages such as Pandas, Seaborn and Matplotlib are already installed. 
+You can add further packages if needed.
+Data files are accessible from the /mnt/data/ directory (this is the current working directory).
+Visualisations should be saved as .png files in the current working directory.
+Extract key insights that would be compelling for a social media campaign.
+""",
+    servers=["interpreter"],
+    request_params=RequestParams(maxTokens=8192),
+    model="sonnet",
+)
+@fast.agent(
+    "evaluator",
+    """You are collaborating with a Data Analysis tool that has the capability to analyse data and produce visualisations.
+    You must make sure that the tool has:
+     - Considered the best way for a Human to interpret the data
+     - Produced insightful visualisations.
+     - Provided a high level summary report for the Human.
+     - Has had its findings challenged, and justified
+     - Extracted compelling insights suitable for social media promotion
+    """,
+    request_params=RequestParams(maxTokens=8192),
+    model="gpt-4o",
+)
+@fast.evaluator_optimizer(
+    "analysis_tool",
+    generator="data_analysis",
+    evaluator="evaluator",
+    max_refinements=3,
+    min_rating="EXCELLENT",
+)
+# Research component using Brave search
+@fast.agent(
+    "context_researcher",
+    """You are a research specialist who provides cultural context for different regions.
+    For any given data insight and target language/region, research:
+    1. Cultural sensitivities related to presenting this type of data
+    2. Local social media trends and preferences
+    3. Region-specific considerations for marketing campaigns
+    
+    Always provide actionable recommendations for adapting content to each culture.
+    """,
+    servers=["fetch", "brave"],  # Using the fetch MCP server for Brave search
+    request_params=RequestParams(temperature=0.3),
+    model="gpt-4o",
+)
+# Social media content generator
+@fast.agent(
+    "campaign_generator",
+    """Generate engaging social media content based on data insights.
+    Create compelling, shareable content that:
+    - Highlights key research findings in an accessible way
+    - Uses appropriate tone for the platform (Twitter/X, LinkedIn, Instagram, etc.)
+    - Is concise and impactful
+    - Includes suggested hashtags and posting schedule
+    
+    Format your response with clear sections for each platform.
+    Save different campaign elements as separate files in the current directory.
+    """,
+    servers=["filesystem"],  # Using filesystem MCP server to save files
+    request_params=RequestParams(temperature=0.7),
+    model="sonnet",
+    use_history=False,
+)
+# Translation agents with cultural adaptation
+@fast.agent(
+    "translate_fr",
+    """Translate social media content to French with cultural adaptation.
+    Consider French cultural norms, expressions, and social media preferences.
+    Ensure the translation maintains the impact of the original while being culturally appropriate.
+    Save the translated content to a file with appropriate naming.
+    """,
+    model="haiku",
+    use_history=False,
+    servers=["filesystem"],
+)
+@fast.agent(
+    "translate_es",
+    """Translate social media content to Spanish with cultural adaptation.
+    Consider Spanish-speaking cultural contexts, expressions, and social media preferences.
+    Ensure the translation maintains the impact of the original while being culturally appropriate.
+    Save the translated content to a file with appropriate naming.
+    """,
+    model="haiku",
+    use_history=False,
+    servers=["filesystem"],
+)
+@fast.agent(
+    "translate_de",
+    """Translate social media content to German with cultural adaptation.
+    Consider German cultural norms, expressions, and social media preferences.
+    Ensure the translation maintains the impact of the original while being culturally appropriate.
+    Save the translated content to a file with appropriate naming.
+    """,
+    model="haiku",
+    use_history=False,
+    servers=["filesystem"],
+)
+@fast.agent(
+    "translate_ja",
+    """Translate social media content to Japanese with cultural adaptation.
+    Consider Japanese cultural norms, expressions, and social media preferences.
+    Ensure the translation maintains the impact of the original while being culturally appropriate.
+    Save the translated content to a file with appropriate naming.
+    """,
+    model="haiku",
+    use_history=False,
+    servers=["filesystem"],
+)
+# Parallel workflow for translations
+@fast.parallel(
+    "translate_campaign",
+    instruction="Translates content to French, Spanish, German and Japanese. Supply the content to translate, translations will be saved to the filesystem.",
+    fan_out=["translate_fr", "translate_es", "translate_de", "translate_ja"],
+    include_request=True,
+)
+# Cultural sensitivity review agent
+@fast.agent(
+    "cultural_reviewer",
+    """Review all translated content for cultural sensitivity and appropriateness.
+    For each language version, evaluate:
+    - Cultural appropriateness
+    - Potential misunderstandings or sensitivities
+    - Effectiveness for the target culture
+    
+    Provide specific recommendations for any needed adjustments and save a review report.
+    """,
+    servers=["filesystem"],
+    request_params=RequestParams(temperature=0.2),
+)
+# Campaign optimization workflow
+@fast.evaluator_optimizer(
+    "campaign_optimizer",
+    generator="campaign_generator",
+    evaluator="cultural_reviewer",
+    max_refinements=2,
+    min_rating="EXCELLENT",
+)
+# Main workflow orchestration
+@fast.orchestrator(
+    "research_campaign_creator",
+    instruction="""
+    Create a complete multi-lingual social media campaign based on data analysis results.
+    The workflow will:
+    1. Analyze the provided data and extract key insights
+    2. Research cultural contexts for target languages
+    3. Generate appropriate social media content
+    4. Translate and culturally adapt the content
+    5. Review and optimize all materials
+    6. Save all campaign elements to files
+    """,
+    agents=[
+        "analysis_tool",
+        "context_researcher",
+        "campaign_optimizer",
+        "translate_campaign",
+    ],
+    model="sonnet",  # Using a more capable model for orchestration
+    request_params=RequestParams(maxTokens=8192),
+    plan_type="full",
+)
+async def main() -> None:
+    # Use the app's context manager
+    print(
+        "WARNING: This workflow will likely run for >10 minutes and consume a lot of tokens. Press Enter to accept the default prompt and proceed"
+    )
+
+    async with fast.run() as agent:
+        await agent.research_campaign_creator.prompt(
+            default_prompt="Analyze the CSV file in the current directory and create a comprehensive multi-lingual social media campaign based on the findings. Save all campaign elements as separate files."
+        )
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

mcp_agent/resources/examples/data-analysis/analysis.py

@@ -0,0 +1,65 @@
+import asyncio
+
+from mcp_agent.core.fastagent import FastAgent
+from mcp_agent.llm.augmented_llm import RequestParams
+
+# Create the application
+fast = FastAgent("Data Analysis (Roots)")
+
+
+# The sample data is under Database Contents License (DbCL) v1.0.
+# Available here : https://www.kaggle.com/datasets/pavansubhasht/ibm-hr-analytics-attrition-dataset
+
+
+@fast.agent(
+    name="data_analysis",
+    instruction="""
+You have access to a Python 3.12 interpreter and you can use this to analyse and process data. 
+Common analysis packages such as Pandas, Seaborn and Matplotlib are already installed. 
+You can add further packages if needed.
+Data files are accessible from the /mnt/data/ directory (this is the current working directory).
+Visualisations should be saved as .png files in the current working directory.
+""",
+    servers=["interpreter"],
+    request_params=RequestParams(maxTokens=8192),
+)
+async def main() -> None:
+    # Use the app's context manager
+    async with fast.run() as agent:
+        await agent(
+            "There is a csv file in the current directory. "
+            "Analyse the file, produce a detailed description of the data, and any patterns it contains.",
+        )
+        await agent(
+            "Consider the data, and how to usefully group it for presentation to a Human. Find insights, using the Python Interpreter as needed.\n"
+            "Use MatPlotLib to produce insightful visualisations. Save them as '.png' files in the current directory. Be sure to run the code and save the files.\n"
+            "Produce a summary with major insights to the data",
+        )
+        await agent()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+
+
+############################################################################################################
+# Example of evaluator/optimizer flow
+############################################################################################################
+# @fast.agent(
+#     "evaluator",
+#     """You are collaborating with a Data Analysis tool that has the capability to analyse data and produce visualisations.
+#     You must make sure that the tool has:
+#      - Considered the best way for a Human to interpret the data
+#      - Produced insightful visualasions.
+#      - Provided a high level summary report for the Human.
+#      - Has had its findings challenged, and justified
+#     """,
+#     request_params=RequestParams(maxTokens=8192),
+# )
+# @fast.evaluator_optimizer(
+#     "analysis_tool",
+#     generator="data_analysis",
+#     evaluator="evaluator",
+#     max_refinements=3,
+#     min_rating="EXCELLENT",
+# )

mcp_agent/resources/examples/data-analysis/fastagent.config.yaml

@@ -0,0 +1,41 @@
+default_model: sonnet
+
+# on windows, adjust the mount point to be the full path e.g. x:/temp/data-analysis/mount-point:/mnt/data/
+
+mcp:
+  servers:
+    interpreter:
+      command: "docker"
+      args:
+        [
+          "run",
+          "-i",
+          "--rm",
+          "--pull=always",
+          "-v",
+          "./mount-point:/mnt/data/",
+          "ghcr.io/evalstate/mcp-py-repl:latest",
+        ]
+      roots:
+        - uri: "file://./mount-point/"
+          name: "test_data"
+          server_uri_alias: "file:///mnt/data/"
+    filesystem:
+      # On windows update the command and arguments to use `node` and the absolute path to the server.
+      # Use `npm i -g @modelcontextprotocol/server-filesystem` to install the server globally.
+      # Use `npm -g root` to find the global node_modules path.`
+      # command: "node"
+      # args: ["c:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-filesystem/dist/index.js","."]
+      command: "npx"
+      args: ["-y", "@modelcontextprotocol/server-filesystem", "./mount-point/"]
+    fetch:
+      command: "uvx"
+      args: ["mcp-server-fetch"]
+    brave:
+      # On windows replace the command and args line to use `node` and the absolute path to the server.
+      # Use `npm i -g @modelcontextprotocol/server-brave-search` to install the server globally.
+      # Use `npm -g root` to find the global node_modules path.`
+      # command: "node"
+      # args: ["c:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-brave-search/dist/index.js"]
+      command: "npx"
+      args: ["-y", "@modelcontextprotocol/server-brave-search"]