Add geocoding interface and about tab to Geocalc MCP server

.gitignore

@@ -0,0 +1,3 @@
+.env
+.idea
+__pycache__

.python-version

@@ -0,0 +1 @@
+3.11

app.py

@@ -1,26 +1,43 @@
 import gradio as gr
+from tools import get_coords_from_address
 
-def letter_counter(word, letter):
-    """
-    Count the number of occurrences of a letter in a word or text.
-    Args:
-        word (str): The input text to search through
-        letter (str): The letter to search for
-    Returns:
-        str: A message indicating how many times the letter appears
-    """
-    word = word.lower()
-    letter = letter.lower()
-    count = word.count(letter)
-    return count
-
-demo = gr.Interface(
-    fn=letter_counter,
-    inputs=[gr.Textbox("strawberry"), gr.Textbox("r")],
-    outputs=[gr.Number()],
-    title="Letter Counter",
-    description="Enter text and a letter to count how many times the letter appears in the text."
+# --- Tool 1: Geocoding Interface ---
+geocoding_interface = gr.Interface(
+    fn=get_coords_from_address,
+    inputs=[
+        gr.Textbox(label="Address", placeholder="e.g., 1600 Amphitheatre Parkway, Mountain View, CA")
+    ],
+    outputs=[
+        gr.Textbox(label="Coordinates (Lat, Lon)")
+    ],
+    title="Address to Coordinates",
+    description="A tool to get the latitude and longitude for a given street address."
 )
 
+# --- About Tab ---
+# It's good practice to have a home/about tab. We create it using gr.Blocks and gr.Markdown.
+with gr.Blocks() as about_tab:
+    gr.Markdown("""
+    # 🌍 Geocalc MCP Server
+
+    Welcome to the Geocalc MCP server. This application provides a collection of tools for geographic calculations.
+
+    This server is designed to be used by AI models (like LLMs) to perform geo-related tasks.
+
+    ## Available Tools
+
+    - **Address Geocoding**: Converts a physical address into latitude and longitude coordinates.
+
+    Use the tabs above to navigate to the desired tool.
+    """)
+
+# --- Assemble the Tabbed Interface ---
+demo = gr.TabbedInterface(
+    [about_tab, geocoding_interface],
+    ["About", "Address Geocoding"],
+    title="🌍 Geocalc MCP Server"
+)
+
+# --- Launch the Server ---
 if __name__ == "__main__":
-    demo.launch(mcp_server=True)
+    demo.launch(mcp_server=True)

pyproject.toml

@@ -0,0 +1,11 @@
+[project]
+name = "geocalc-mcp"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "geopy>=2.4.1",
+    "gradio>=5.33.0",
+    "mcp>=1.9.3",
+]

tools.py

@@ -0,0 +1,30 @@
+from geopy.geocoders import Nominatim
+
+def get_coords_from_address(address: str) -> str:
+    """
+    Converts a street address into latitude and longitude coordinates.
+
+    Args:
+        address (str): The address to search for (e.g., "Eiffel Tower, Paris").
+
+    Returns:
+        str: A formatted string with the coordinates "Lat: XX.XXXX, Lon: YY.YYYY"
+             or an error message if the address is not found.
+    """
+    print("get_coords_from_address() called with address:", address)
+    # 1. Initialize a geocoder. Nominatim is a great free option based on
+    #    OpenStreetMap. It doesn't require an API key for basic use.
+    #    geolocator = Nominatim(user_agent="geocalc_mcp_app")
+
+    # 2. Use the geocoder to find the location from the 'address' string.
+    #    location = geolocator.geocode(address)
+
+    # 3. Check if a location was found.
+    #    - If 'location' is not None, extract 'location.latitude' and 'location.longitude'.
+    #    - Format the result into a string like "Lat: 48.8584, Lon: 2.2945".
+    #    - If 'location' is None, return a clear message like "Address not found."
+
+    # For now, you can use a temporary return value to test the interface.
+    # For example:
+    # return f"Processing address: {address}"
+    return "Lat: 48.8584, Lon: 2.2945"