fast-agent-mcp 0.3.8__tar.gz → 0.3.9__tar.gz

{fast_agent_mcp-0.3.8 → fast_agent_mcp-0.3.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.3.8
+Version: 0.3.9
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>
 License:                                  Apache License
@@ -219,15 +219,15 @@ Requires-Dist: email-validator>=2.2.0
 Requires-Dist: fastapi>=0.115.6
 Requires-Dist: google-genai>=1.33.0
 Requires-Dist: keyring>=24.3.1
-Requires-Dist: mcp==1.14.0
-Requires-Dist: openai>=1.108.0
+Requires-Dist: mcp==1.15.0
+Requires-Dist: openai>=1.109.1
 Requires-Dist: opentelemetry-distro>=0.55b0
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.7.0
 Requires-Dist: opentelemetry-instrumentation-anthropic>=0.43.1; python_version >= '3.10' and python_version < '4.0'
 Requires-Dist: opentelemetry-instrumentation-google-genai>=0.3b0
 Requires-Dist: opentelemetry-instrumentation-mcp>=0.43.1; python_version >= '3.10' and python_version < '4.0'
 Requires-Dist: opentelemetry-instrumentation-openai>=0.43.1; python_version >= '3.10' and python_version < '4.0'
-Requires-Dist: prompt-toolkit>=3.0.51
+Requires-Dist: prompt-toolkit>=3.0.52
 Requires-Dist: pydantic-settings>=2.7.0
 Requires-Dist: pydantic>=2.10.4
 Requires-Dist: pyperclip>=1.9.0
@@ -280,7 +280,7 @@ Start by installing the [uv package manager](https://docs.astral.sh/uv/) for Pyt
 ```bash
 uv pip install fast-agent-mcp          # install fast-agent!
 fast-agent go                          # start an interactive session
-fast-agent go https://hf.co/mcp        # with a remote MCP
+fast-agent go --url https://hf.co/mcp  # with a remote MCP
 fast-agent go --model=generic.qwen2.5  # use ollama qwen 2.5
 fast-agent setup                       # create an example agent and config files
 uv run agent.py                        # run your first agent

{fast_agent_mcp-0.3.8 → fast_agent_mcp-0.3.9}/README.md

@@ -41,7 +41,7 @@ Start by installing the [uv package manager](https://docs.astral.sh/uv/) for Pyt
 ```bash
 uv pip install fast-agent-mcp          # install fast-agent!
 fast-agent go                          # start an interactive session
-fast-agent go https://hf.co/mcp        # with a remote MCP
+fast-agent go --url https://hf.co/mcp  # with a remote MCP
 fast-agent go --model=generic.qwen2.5  # use ollama qwen 2.5
 fast-agent setup                       # create an example agent and config files
 uv run agent.py                        # run your first agent

{fast_agent_mcp-0.3.8/src/fast_agent/resources → fast_agent_mcp-0.3.9}/examples/data-analysis/analysis.py

@@ -18,18 +18,22 @@ Common analysis packages such as Pandas, Seaborn and Matplotlib are already inst
 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.
+
+{{serverInstructions}}
+
 """,
     servers=["interpreter"],
 )
-@fast.agent(name="another_test", instruction="", servers=["filesystem"])
+# @fast.agent(name="another_test", instruction="", servers=["filesystem"])
 async def main() -> None:
     # Use the app's context manager
     async with fast.run() as agent:
-        await agent(
+        await agent.interactive()
+        await agent.data_analysis(
             "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(
+        await agent.data_analysis(
             "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",

fast_agent_mcp-0.3.9/examples/openapi/agent.py

@@ -0,0 +1,25 @@
+import asyncio
+
+from fast_agent import FastAgent
+
+# Create the application
+fast = FastAgent("fast-agent example")
+
+
+default_instruction = """You are a helpful AI Agent.
+
+{{serverInstructions}}
+
+The current date is {{currentDate}}."""
+
+
+# Define the agent
+@fast.agent(instruction=default_instruction,servers=["petstore"])
+async def main():
+    # use the --model command line switch or agent arguments to change model
+    async with fast.run() as agent:
+        await agent.interactive()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fast_agent_mcp-0.3.9/examples/openapi/fastagent.config.yaml

@@ -0,0 +1,44 @@
+# FastAgent Configuration File
+
+# Default Model Configuration:
+#
+# Takes format:
+#   <provider>.<model_string>.<reasoning_effort?> (e.g. anthropic.claude-3-5-sonnet-20241022 or openai.o3-mini.low)
+# Accepts aliases for Anthropic Models: haiku, haiku3, sonnet, sonnet35, opus, opus3
+# and OpenAI Models: gpt-4.1, gpt-4.1-mini, o1, o1-mini, o3-mini
+#
+# If not specified, defaults to "gpt-5-mini.low".
+# Can be overriden with a command line switch --model=<model>, or within the Agent constructor.
+
+default_model: gpt-5-mini.low
+# mcp-ui support: disabled, enabled or auto. "auto" opens the web browser on the asset automatically
+# mcp_ui_output_dir: ".fast-agent/ui"  # Where to write MCP-UI HTML files (relative to CWD if not absolute)
+# mcp_ui_mode: enabled
+
+# Logging and Console Configuration:
+logger:
+  # level: "debug" | "info" | "warning" | "error"
+  # type: "none" | "console" | "file" | "http"
+  # path: "/path/to/logfile.jsonl"
+
+  # Switch the progress display on or off
+  progress_display: true
+
+  # Show chat User/Assistant messages on the console
+  show_chat: true
+  # Show tool calls on the console
+  show_tools: true
+  # Truncate long tool responses on the console
+  truncate_tools: true
+
+# MCP Servers
+mcp:
+  servers:
+    petstore:
+      command: "uv"
+      args: ["run","openapi_mcp_server.py","petstore.yaml"]
+    filesystem:
+      command: "npx"
+      args: ["-y", "@modelcontextprotocol/server-filesystem", "."]
+    huggingface:
+      url: "https://huggingface.co/mcp?login"

fast_agent_mcp-0.3.9/examples/openapi/openapi_mcp_server.py

@@ -0,0 +1,136 @@
+"""OpenAPI MCP server that exposes the provided specification and an API invocation tool."""
+
+from __future__ import annotations
+
+import argparse
+import logging
+from pathlib import Path
+from typing import Any, Dict
+
+import httpx
+import yaml
+from mcp.server.fastmcp import FastMCP
+from pydantic import BaseModel, Field
+
+
+class ApiCallRequest(BaseModel):
+    """Structured request payload for the OpenAPI invocation tool."""
+
+    method: str = Field(..., description="HTTP method to use, e.g. GET or POST.")
+    path: str = Field(..., description="Endpoint path, such as /pets or pets.")
+    query: Dict[str, Any] | None = Field(
+        default=None, description="Optional query string parameters, keyed by name."
+    )
+    body: Any | None = Field(default=None, description="Optional JSON request body.")
+    headers: Dict[str, str] | None = Field(
+        default=None, description="Optional HTTP headers to include with the request."
+    )
+    timeout: float | None = Field(
+        default=30.0, description="Optional request timeout (seconds); defaults to 30."
+    )
+
+
+def load_spec(spec_path: Path) -> tuple[str, str | None]:
+    """Return the raw spec text and the first server URL, if any."""
+    if not spec_path.exists():
+        raise FileNotFoundError(f"OpenAPI specification not found: {spec_path}")
+
+    spec_text = spec_path.read_text()
+    try:
+        data = yaml.safe_load(spec_text) or {}
+    except yaml.YAMLError as exc:
+        raise ValueError(f"Failed to parse OpenAPI specification: {exc}") from exc
+
+    base_url: str | None = None
+    servers = data.get("servers", [])
+    for entry in servers:
+        if isinstance(entry, dict) and "url" in entry:
+            base_url = entry["url"]
+            break
+
+    return spec_text, base_url
+
+
+def build_server(spec_text: str, base_url: str | None, server_name: str) -> FastMCP:
+    instructions = (
+        "Here is the API specification you have access to:\n\n"
+        f"{spec_text}\n\n"
+        "When issuing requests, do not return more than 50 results in a single query."
+    )
+
+    mcp = FastMCP(server_name, instructions=instructions, log_level="INFO")
+
+    @mcp.tool(
+        name="call_openapi_endpoint",
+        description=(
+            "Invoke an API endpoint from the supplied OpenAPI document. "
+            "Provide the HTTP method (GET, POST, etc.), the endpoint path (e.g. /pets), "
+            "and optional query parameters, JSON body, or headers."
+        ),
+    )
+    async def call_openapi_endpoint(request: ApiCallRequest) -> Dict[str, Any]:
+        if not base_url:
+            raise RuntimeError("The OpenAPI specification does not define a server URL to call.")
+
+        path = request.path if request.path.startswith("/") else f"/{request.path}"
+        timeout = request.timeout if request.timeout is not None else 30.0
+
+        async with httpx.AsyncClient(base_url=base_url, timeout=timeout) as client:
+            response = await client.request(
+                request.method.upper(),
+                path,
+                params=request.query,
+                json=request.body,
+                headers=request.headers,
+            )
+
+        try:
+            payload = response.json()
+        except ValueError:
+            payload = None
+
+        result: Dict[str, Any] = {
+            "status_code": response.status_code,
+            "headers": dict(response.headers),
+        }
+
+        if isinstance(payload, list):
+            limited_payload = payload[:50]
+            result["json"] = limited_payload
+            if len(payload) > 50:
+                result["truncated"] = True
+                result["truncated_count"] = len(payload) - 50
+                result["note"] = (
+                    "Response contained more than 50 items; returning the first 50 to comply with instructions."
+                )
+        elif payload is not None:
+            result["json"] = payload
+        else:
+            result["text"] = response.text
+
+        return result
+
+    return mcp
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Run an MCP server backed by an OpenAPI specification.")
+    parser.add_argument("spec", help="Path to the OpenAPI specification (YAML or JSON).")
+    parser.add_argument(
+        "--name",
+        default="OpenAPI MCP Server",
+        help="Optional server name to present to clients (default: OpenAPI MCP Server).",
+    )
+    args = parser.parse_args()
+
+    spec_path = Path(args.spec)
+    spec_text, base_url = load_spec(spec_path)
+
+    logging.basicConfig(level=logging.INFO)
+
+    server = build_server(spec_text, base_url, args.name)
+    server.run("stdio")
+
+
+if __name__ == "__main__":
+    main()