SouthAsia MCP Tool

Instructions

Implementation Reference

• src/southasia/handlers/hello_world.py:65-75 (handler)

  The core handler logic for the 'mcp_hello_name' tool. It extracts the user's name from the arguments, validates its presence, and returns a personalized greeting message as TextContent.

  elif name == "mcp_hello_name":
      user_name = arguments.get("name")
      if not user_name:
          raise ValueError("缺少名字參數")
          
      return [
          types.TextContent(
              type="text",
              text=f"Hello {user_name}! 很高興見到您！"
          )
      ]

• src/southasia/handlers/hello_world.py:27-40 (schema)

  The JSON schema definition for the 'mcp_hello_name' tool, specifying the required 'name' string parameter.

  types.Tool(
      name="mcp_hello_name",
      description="A demonstration tool that greets you by name",
      inputSchema={
          "type": "object",
          "properties": {
              "name": {
                  "type": "string",
                  "description": "Your name"
              }
          },
          "required": ["name"],
      },
  ),

• src/southasia/server.py:31-37 (registration)

  Registration of the hello_world handler module in the HANDLERS list using prefix 'mcp_hello', which routes tool calls for 'mcp_hello_name' to the appropriate list_tools and call_tool functions in hello_world.py.

  HANDLERS = [
      {
          "prefixes": ["mcp_hello"],
          "list_tools": hello_world_list_tools,
          "call_tool": hello_world_call_tool
      }
  ]