MCP Server Template for Cursor IDE

Instructions

Implementation Reference

• mcp_simple_tool/server.py:8-39 (handler)

  Core handler function that implements the mcp_fetch tool logic by fetching website content via httpx and handling errors.

  async def fetch_website(
      url: str,
  ) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
      headers = {
          "User-Agent": "MCP Test Server (github.com/modelcontextprotocol/python-sdk)"
      }
      try:
          timeout = httpx.Timeout(10.0, connect=5.0)
          async with httpx.AsyncClient(
              follow_redirects=True, 
              headers=headers,
              timeout=timeout
          ) as client:
              response = await client.get(url)
              response.raise_for_status()
              return [types.TextContent(type="text", text=response.text)]
      except httpx.TimeoutException:
          return [types.TextContent(
              type="text",
              text="Error: Request timed out while trying to fetch the website."
          )]
      except httpx.HTTPStatusError as e:
          return [types.TextContent(
              type="text",
              text=(f"Error: HTTP {e.response.status_code} "
                    "error while fetching the website.")
          )]
      except Exception as e:
          return [types.TextContent(
              type="text",
              text=f"Error: Failed to fetch website: {str(e)}"
          )]

• mcp_simple_tool/server.py:72-78 (handler)

  Dispatch logic in the call_tool handler that invokes fetch_website for mcp_fetch.

  if name == "mcp_fetch":
      if "url" not in arguments:
          return [types.TextContent(
              type="text",
              text="Error: Missing required argument 'url'"
          )]
      return await fetch_website(arguments["url"])

• mcp_simple_tool/server.py:95-107 (registration)

  Tool registration including name, description, and input schema for mcp_fetch.

  types.Tool(
      name="mcp_fetch",
      description="Fetches a website and returns its content",
      inputSchema={
          "type": "object",
          "required": ["url"],
          "properties": {
              "url": {
                  "type": "string",
                  "description": "URL to fetch",
              }
          },
      },

• mcp_simple_tool/server.py:95-107 (schema)

  Input schema definition for the mcp_fetch tool.

  types.Tool(
      name="mcp_fetch",
      description="Fetches a website and returns its content",
      inputSchema={
          "type": "object",
          "required": ["url"],
          "properties": {
              "url": {
                  "type": "string",
                  "description": "URL to fetch",
              }
          },
      },