Build a Focus Apps

research/
├── research.py      # MCP server with tools
├── truffile.yaml    # App configuration
└── icon.png         # App icon (optional)

metadata:
  name: Research
  type: foreground
  description: |
    Tools to help your Truffle research and gather information from the web.
  process:
    cmd:
      - python
      - research.py
    working_directory: /
    environment:
      PYTHONUNBUFFERED: "1"
  icon_file: ./icon.png

files:
  - source: ./research.py
    destination: ./research.py

run: |
  pip install mcp requests ddgs

from mcp.server.fastmcp import FastMCP

HOST = "0.0.0.0"
PORT = 8000

# Create the MCP server
mcp = FastMCP("research", stateless_http=True, host=HOST, port=PORT)


@mcp.tool("search_web", description="Search the web using DuckDuckGo. Returns titles and URLs for the query.")
async def search_web(query: str, num_results: int = 5) -> str:
    """Search the web for information."""
    from ddgs import DDGS
    
    results = DDGS().text(query, max_results=num_results)
    formatted = "\n".join([
        f"{i+1}. {r['title']}: {r['href']}" 
        for i, r in enumerate(results)
    ])
    return formatted


@mcp.tool("search_news", description="Search for recent news articles. Returns headlines with sources and URLs.")
async def search_news(query: str, num_results: int = 5) -> str:
    """Search for news articles."""
    from ddgs import DDGS
    
    results = DDGS().news(query, max_results=num_results)
    formatted = "\n".join([
        f"{i+1}. [{r['source']}] {r['title']}: {r['url']}" 
        for i, r in enumerate(results)
    ])
    return formatted


@mcp.tool("fetch_url_content", description="Fetches and extracts the main text content from a URL. Useful for reading articles.")
async def fetch_url_content(url: str) -> str:
    """Extract content from a webpage."""
    import requests
    
    try:
        resp = requests.get(url, timeout=10)
        resp.raise_for_status()
        # Simple extraction - in production, use a proper extractor
        return resp.text[:5000]  # First 5000 chars
    except Exception as e:
        return f"Error fetching URL: {e}"


def main():
    print(f"Starting Research MCP server on {HOST}:{PORT}")
    mcp.run(transport="streamable-http")


if __name__ == "__main__":
    main()

from mcp.server.fastmcp import FastMCP

# 1. Create the server
mcp = FastMCP("app-name", stateless_http=True, host="0.0.0.0", port=8000)

# 2. Define tools with @mcp.tool()
@mcp.tool("tool_name", description="What this tool does")
async def my_tool(param: str) -> str:
    # Tool logic here
    return result

# 3. Run the server
mcp.run(transport="streamable-http")

@mcp.tool("tool_name", description="Clear description of what this tool does")
async def tool_name(param1: str, param2: int = 5) -> str:
    ...

@mcp.tool("example")
async def example(
    query: str,           # Required string
    limit: int = 10,      # Optional int with default
    include_images: bool = False  # Optional bool
) -> str:
    ...

from mcp.server.fastmcp import FastMCP

mcp = FastMCP(
    name="my-app",           # App identifier
    stateless_http=True,     # Required for Truffle
    host="0.0.0.0",          # Listen on all interfaces
    port=8000                # Must be 8000
)

@mcp.tool(name, description)
async def tool_function(params...) -> str:
    ...

mcp.run(transport="streamable-http")

cd research
truffile deploy