[{"_1":2,"_267":-5,"_268":-5},"loaderData",{"_3":4,"_31":32,"_206":207},"root",{"_5":6,"_14":15},"toasts",[7],{"_8":9,"_10":11,"_12":13},"uid","019ab57d-24c8-73cf-9999-9cbeb7ce1e34","title","This MCP server does not support inspection","type","error","visitor",{"_16":17,"_18":19},"viewportWidth",1280,"visitorSession",{"_20":21,"_23":24,"_25":-5,"_26":27,"_28":29,"_30":-5},"attributes",[22],"bot","id",27182804,"membership","referenceId","019ab33c-32bd-768e-80e6-9ee61bfabc38","unreadReleaseNotesCount",2,"userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_33":34,"_35":-5,"_36":37,"_38":50,"_125":126,"_205":109},"availableLocales",[],"githubUser","locale",{"_38":39,"_46":47,"_48":49},"mcpServer",{"_40":41,"_42":43,"_44":45},"description","A learning project demonstrating how to build MCP servers with Python, featuring weather query tools that showcase custom tool creation, configuration, and integration with AI assistants.","displayName","Weather Service MCP","readme","# MCP Learning Project 2025\n\nA hands-on project to demonstrate building and deploying **Model Context Protocol (MCP)** servers. This project showcases how to create custom MCP tools, configure them for AI assistants, and integrate them with various clients like Claude Desktop, Continue, and other MCP-compatible applications.\n\n## Tech Stack\n\n| Category | Technology | Purpose |\n|----------|------------|---------|\n| **Language** | Python 3.13+ | Core programming language |\n| **Protocol** | MCP (Model Context Protocol) | Standardized AI-tool communication |\n| **Framework** | FastMCP | Rapid MCP server development |\n| **Package Manager** | UV or pip + venv | Dependency management |\n| **Validation** | Pydantic | Data validation and type safety |\n| **Server** | Uvicorn | ASGI server for MCP |\n\n## Prerequisites\n\n- **Python 3.13+** installed on your system\n- **UV** (recommended) or **pip + venv** for package management\n- **VS Code** (optional but recommended for MCP configuration)\n- **Git** for version control\n\n## Installation\n\n\n\n\n\n\n\n\n\n\n

Using UV (Recommended)	Using pip + venv
\n\n1. Install UV:\n```bash\n# Windows (PowerShell)\npowershell -c \"irm https://astral.sh/uv/install.ps1 \| iex\"\n```\n\n2. Initialize project:\n```bash\n# Create new project\nuv init learn-mcp-2025\ncd learn-mcp-2025\n\n# Or in existing directory\nuv init\n```\n\n3. Add MCP dependencies:\n```bash\n# Add MCP with CLI tools\nuv add \"mcp[cli]\"\n\n# This creates/updates:\n# - pyproject.toml\n# - uv.lock\n```\n\n4. Install all dependencies:\n```bash\nuv sync\n```\n\n	\n\n1. Navigate to project:\n```bash\ncd learn-mcp-2025\n```\n\n2. Create virtual environment:\n```bash\npython -m venv .venv\n```\n\n3. Activate virtual environment:\n```bash\n# Windows (PowerShell)\n.venv\\Scripts\\Activate.ps1\n\n# Windows (CMD)\n.venv\\Scripts\\activate.bat\n```\n\n4. Install dependencies:\n```bash\n# From requirements.txt\npip install -r requirements.txt\n\n# Or install package in editable mode\npip install -e .\n```\n\n

Using UV (Recommended)

Using pip + venv

\n\n**1. Install UV:**\n```bash\n# Windows (PowerShell)\npowershell -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\n**2. Initialize project:**\n```bash\n# Create new project\nuv init learn-mcp-2025\ncd learn-mcp-2025\n\n# Or in existing directory\nuv init\n```\n\n**3. Add MCP dependencies:**\n```bash\n# Add MCP with CLI tools\nuv add \"mcp[cli]\"\n\n# This creates/updates:\n# - pyproject.toml\n# - uv.lock\n```\n\n**4. Install all dependencies:**\n```bash\nuv sync\n```\n\n

\n\n**1. Navigate to project:**\n```bash\ncd learn-mcp-2025\n```\n\n**2. Create virtual environment:**\n```bash\npython -m venv .venv\n```\n\n**3. Activate virtual environment:**\n```bash\n# Windows (PowerShell)\n.venv\\Scripts\\Activate.ps1\n\n# Windows (CMD)\n.venv\\Scripts\\activate.bat\n```\n\n**4. Install dependencies:**\n```bash\n# From requirements.txt\npip install -r requirements.txt\n\n# Or install package in editable mode\npip install -e .\n```\n\n

\n\n### Generated Files\n\n| UV | pip + venv |\n|----|------------|\n| `pyproject.toml` - Project metadata and dependencies | `requirements.txt` - Pinned dependencies |\n| `uv.lock` - Locked dependency versions | `.venv/` - Virtual environment directory |\n\n## MCP Server Configuration\n\nTo integrate your MCP server with AI clients (like Claude Desktop), create a configuration file:\n\n### Create `.vscode/mcp.json`\n\n```json\n{\n \"servers\": {\n \"weather-service\": {\n \"command\": \"python\",\n \"args\": [\"weather.py\"],\n \"env\": {}\n }\n }\n}\n```\n\n### Multi-Server Configuration\n\n```json\n{\n \"servers\": {\n \"weather-service\": {\n \"command\": \"python\",\n \"args\": [\"weather.py\"],\n \"env\": {}\n },\n \"winget-mcp\": {\n \"type\": \"stdio\",\n \"command\": \"C:\\\\Users\\\\YourUser\\\\AppData\\\\Local\\\\Microsoft\\\\WindowsApps\\\\...\\\\WindowsPackageManagerMCPServer.exe\"\n }\n }\n}\n```\n\n### Configuration Options\n\n| Field | Description | Example |\n|-------|-------------|---------|\n| `command` | Executable to run | `python`, `node`, `uv` |\n| `args` | Arguments passed to command | `[\"weather.py\"]`, `[\"run\", \"server.py\"]` |\n| `env` | Environment variables | `{\"API_KEY\": \"value\"}` |\n| `type` | Communication type | `stdio` (default) |\n\n## Running the MCP Server\n\n### Method 1: Quick Testing (Direct Function Call)\n\nTest individual functions without starting the full MCP server:\n\n\n\n\n\n\n\n\n\n\n

Using UV	Using pip + venv
\n\n```bash\nuv run python -c \"from weather import get_weather; print(get_weather('London'))\"\n```\n\nOutput:\n```\nThe current weather in London is sunny with a temperature of 25°C.\n```\n\n	\n\n```bash\n# Activate venv first\n.venv\\Scripts\\Activate.ps1\n\n# Then run\npython -c \"from weather import get_weather; print(get_weather('London'))\"\n```\n\nOutput:\n```\nThe current weather in London is sunny with a temperature of 25°C.\n```\n\n

\n\n**When to use:**\n- ✅ Fast iteration during development\n- ✅ Unit testing individual tools\n- ✅ Debugging function logic\n- ❌ Won't work with MCP clients\n\n### Method 2: Production Mode (Full MCP Server)\n\nRun as a complete MCP server for AI assistant integration:\n\n\n\n\n\n\n\n\n\n\n

Using UV	Using pip + venv
\n\n```bash\n# Start MCP server\nuv run python weather.py\n\n# The server will start and listen for MCP requests\n```\n\n	\n\n```bash\n# Activate venv first\n.venv\\Scripts\\Activate.ps1\n\n# Start MCP server\npython weather.py\n```\n\n

\n\n**When to use:**\n- ✅ Integration with AI assistants (Claude, Continue, etc.)\n- ✅ Production deployments\n- ✅ Multi-tool servers\n- ✅ Standardized MCP protocol communication\n\n### Method 3: MCP Inspector (Development & Debugging)\n\nUse the MCP Inspector to interactively test your server:\n\n\n\n\n\n\n\n\n\n\n

Using UV	Using pip + venv
\n\n```bash\n# Install MCP inspector (if not installed)\nuv add mcp-inspector\n\n# Start inspector\nuv run mcp dev weather.py\n```\n\n	\n\n```bash\n# Install MCP inspector\npip install mcp-inspector\n\n# Activate venv\n.venv\\Scripts\\Activate.ps1\n\n# Start inspector\nmcp dev weather.py\n```\n\n

\n\n**MCP Inspector Features:**\n- 🔍 Interactive tool testing\n- 📊 Request/response inspection\n- 🐛 Real-time debugging\n- 📝 Schema validation\n- 🔄 Live reload on file changes\n\n**Access Inspector:**\n```\nOpen browser: http://localhost:5173\n```\n\n## Project Structure\n\n```\nlearn-mcp-2025/\n├── .vscode/\n│ └── mcp.json # MCP server configuration for VS Code\n├── .venv/ # Virtual environment (pip only)\n├── weather.py # Main MCP server implementation\n├── pyproject.toml # Project metadata & dependencies (UV)\n├── requirements.txt # Pinned dependencies (pip)\n├── uv.lock # Locked dependency versions (UV)\n├── .python-version # Python version specification\n├── .gitignore # Git ignore rules\n└── README.md # This file\n```\n\n### Key Files Explained\n\n| File | Purpose |\n|------|---------|\n| `weather.py` | MCP server with tools decorated with `@mcp.tool()` |\n| `pyproject.toml` | Modern Python project configuration (PEP 621) |\n| `requirements.txt` | Traditional pip dependency list |\n| `uv.lock` | UV's deterministic dependency lock file |\n| `.vscode/mcp.json` | MCP client configuration for VS Code |\n\n## Quick Command Reference\n\n### UV Commands\n\n| Command | Description |\n|---------|-------------|\n| `uv init` | Initialize new Python project |\n| `uv add ` | Add dependency to project |\n| `uv remove ` | Remove dependency |\n| `uv sync` | Install/sync all dependencies |\n| `uv run ` | Run command in project environment |\n| `uv pip list` | List installed packages |\n| `uv pip show ` | Show package details |\n| `uv lock` | Update lock file |\n| `uv python install ` | Install Python version |\n| `uv python list` | List available Python versions |\n\n### pip + venv Commands\n\n| Command | Description |\n|---------|-------------|\n| `python -m venv .venv` | Create virtual environment |\n| `.venv\\Scripts\\Activate.ps1` | Activate venv (PowerShell) |\n| `.venv\\Scripts\\activate.bat` | Activate venv (CMD) |\n| `pip install -r requirements.txt` | Install dependencies |\n| `pip install -e .` | Install package in editable mode |\n| `pip install ` | Install single package |\n| `pip uninstall ` | Remove package |\n| `pip list` | List installed packages |\n| `pip show ` | Show package details |\n| `pip freeze > requirements.txt` | Export dependencies |\n| `deactivate` | Deactivate virtual environment |\n\n### MCP Commands\n\n| Command | Description |\n|---------|-------------|\n| `mcp dev ` | Start MCP Inspector for development |\n| `mcp --version` | Check MCP CLI version |\n| `python .py` | Start MCP server in production |\n\n## Development Examples\n\n### Example 1: Adding a New Weather Tool\n\nEdit `weather.py`:\n\n```python\nfrom mcp.server.fastmcp import FastMCP\n\nmcp = FastMCP(\"Weather Service\")\n\n@mcp.tool()\ndef get_weather(location: str) -> str:\n \"\"\"Get current weather for a location.\"\"\"\n return f\"The current weather in {location} is sunny with a temperature of 25°C.\"\n\n@mcp.tool()\ndef get_forecast(location: str, days: int = 7) -> str:\n \"\"\"Get weather forecast for the next N days.\"\"\"\n return f\"Forecast for {location} for the next {days} days: Mostly sunny\"\n\n@mcp.tool()\ndef get_temperature(location: str, unit: str = \"celsius\") -> str:\n \"\"\"Get current temperature in specified unit.\"\"\"\n temp = 25 if unit == \"celsius\" else 77\n return f\"Temperature in {location}: {temp}°{unit[0].upper()}\"\n\nif __name__ == \"__main__\":\n mcp.run()\n```\n\n### Example 2: Testing New Tools\n\n```bash\n# Test with UV\nuv run python -c \"from weather import get_forecast; print(get_forecast('Paris', 5))\"\n\n# Test with pip/venv\npython -c \"from weather import get_forecast; print(get_forecast('Paris', 5))\"\n```\n\n### Example 3: Adding Type Safety\n\n```python\nfrom typing import Literal\nfrom mcp.server.fastmcp import FastMCP\n\nmcp = FastMCP(\"Weather Service\")\n\n@mcp.tool()\ndef get_temperature(\n location: str, \n unit: Literal[\"celsius\", \"fahrenheit\"] = \"celsius\"\n) -> str:\n \"\"\"Get temperature with validated unit parameter.\"\"\"\n temp = 25 if unit == \"celsius\" else 77\n return f\"Temperature in {location}: {temp}°{unit[0].upper()}\"\n```\n\n### Example 4: Debugging & Verification\n\n```bash\n# List all tools in your server\nuv run python -c \"from weather import mcp; print(mcp.list_tools())\"\n\n# Check Python version\nuv run python --version\n\n# Verify MCP package\nuv pip show mcp\n\n# Test imports\nuv run python -c \"from weather import mcp; print('MCP initialized successfully')\"\n```\n\n## License\n\nThis project is for learning purposes.\n","name","English","tag","en-US",{"_51":52,"_20":53,"_59":41,"_60":41,"_42":43,"_23":61,"_62":63,"_64":65,"_73":-5,"_74":75,"_76":-5,"_77":78,"_115":116,"_120":-5,"_72":101,"_121":75,"_8":122,"_123":124},"addedAt","2025-11-24T02:03:11.230224Z",[54,55,56,57,58],"category:weather-services","category:developer-tools","environment:network","language:python","license_grade:f","descriptionMarkdown","descriptionPlainText",14332,"integrations",[],"namespace",{"_66":67,"_72":71},"owner",{"_68":69},"githubAccount",{"_70":71},"login","sritajkumarpatel","slug","readmeMarkdown","recentUsage",0,"redditPostExternalId","repository",{"_79":80,"_86":87,"_90":91,"_107":-5,"_108":109,"_110":-5,"_111":112},"argumentsJsonSchema",{"_81":82,"_83":84,"_12":85},"properties",{},"required",[],"object","githubProject",{"_44":45,"_88":89},"url","https://github.com/sritajkumarpatel/learn_mcp_2025","githubRepository",{"_92":93,"_94":95,"_96":97,"_23":98,"_99":100,"_46":101,"_66":102,"_104":75,"_105":-5,"_106":75},"defaultBranch","main","fullName","sritajkumarpatel/learn_mcp_2025","githubTreeId",3398263,41149,"language","Python","learn_mcp_2025",{"_70":71,"_8":103},"pdfi1vd5q8","recentStargazers","spdxLicense","stargazers","glamaJson","inspectable",false,"npmPackage","supportedPlatforms",[113,114],"WINDOWS","MACOS","scores",{"_117":75,"_118":-5,"_119":-5},"license","quality","security","simpleIcon","toolCount","k4leocy0sj","updatedAt","2025-11-24T02:03:24.558044Z","meta",[127,129,131,138,141,143,146,149,152,155,158,160,163,166,168,170,172,174,176],{"_10":128},"Weather Service MCP | Glama",{"_130":41,"_46":40},"content",{"_132":133,"_134":135,"_136":137},"href","https://glama.ai/mcp/servers/@sritajkumarpatel/learn_mcp_2025","rel","canonical","tagName","link",{"_130":43,"_139":140},"property","og:title",{"_130":41,"_139":142},"og:description",{"_130":144,"_139":145},"https://glama.ai/logo.png","og:logo",{"_130":147,"_139":148},"https://glama.ai/mcp/servers/@sritajkumarpatel/learn_mcp_2025/og-image","og:image",{"_130":150,"_139":151},"630","og:image:height",{"_130":153,"_139":154},"1200","og:image:width",{"_130":156,"_139":157},"website","og:type",{"_130":133,"_139":159},"og:url",{"_130":161,"_139":162},"Glama – MCP Hosting Platform","og:site_name",{"_130":164,"_46":165},"summary_large_image","twitter:card",{"_130":161,"_46":167},"twitter:title",{"_130":41,"_46":169},"twitter:description",{"_130":147,"_46":171},"twitter:image",{"_130":150,"_46":173},"twitter:image:height",{"_130":153,"_46":175},"twitter:image:width",{"_177":178},"script:ld+json",{"_179":180,"_181":182},"@context","http://schema.org","@graph",[183],{"_179":184,"_185":186,"_187":188},"https://schema.org","@type","BreadcrumbList","itemListElement",[189,196,199,203],{"_185":190,"_191":192,"_46":193,"_194":195},"ListItem","item","https://glama.ai/","Glama","position",1,{"_185":190,"_191":197,"_46":198,"_194":29},"https://glama.ai/mcp","MCP",{"_185":190,"_191":200,"_46":201,"_194":202},"https://glama.ai/mcp/servers","Servers",3,{"_185":190,"_191":133,"_46":43,"_194":204},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/tree/~commit/~/_route",{"_208":93,"_38":209,"_224":225,"_125":236,"_234":233,"_260":261},"branch",{"_51":52,"_20":210,"_59":41,"_60":41,"_42":43,"_23":61,"_62":211,"_64":212,"_73":-5,"_74":75,"_76":-5,"_77":215,"_115":223,"_120":-5,"_72":101,"_121":75,"_8":122,"_123":124},[54,55,56,57,58],[],{"_66":213,"_72":71},{"_68":214},{"_70":71},{"_79":216,"_86":219,"_90":220,"_107":-5,"_108":109,"_110":-5,"_111":222},{"_81":217,"_83":218,"_12":85},{},[],{"_44":45,"_88":89},{"_92":93,"_94":95,"_96":97,"_23":98,"_99":100,"_46":101,"_66":221,"_104":75,"_105":-5,"_106":75},{"_70":71,"_8":103},[113,114],{"_117":75,"_118":-5,"_119":-5},"member",{"_226":227,"_228":229,"_232":233,"_234":233,"_12":235},"childGitHubTreeId",3398262,"commit",{"_230":231},"sha","ee79a92ec25a4b79b0bae7c4467373267b698e38","fullPath",".vscode","path","tree",[237,239,241,243,245,246,247,249,250,251,252,253,254,255,256,257,258,259],{"_10":238},".vscode | Weather Service MCP | Glama",{"_130":240,"_46":40},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_132":242,"_134":135,"_136":137},"https://glama.ai/mcp/servers/@sritajkumarpatel/learn_mcp_2025/tree/ee79a92ec25a4b79b0bae7c4467373267b698e38/.vscode",{"_130":244,"_139":140},".vscode | Weather Service MCP",{"_130":240,"_139":142},{"_130":144,"_139":145},{"_130":248,"_139":148},"https://glama.ai/generated-images/og?title=.vscode+%7C+Weather+Service+MCP",{"_130":150,"_139":151},{"_130":153,"_139":154},{"_130":156,"_139":157},{"_130":242,"_139":159},{"_130":161,"_139":162},{"_130":164,"_46":165},{"_130":161,"_46":167},{"_130":240,"_46":169},{"_130":248,"_46":171},{"_130":150,"_46":173},{"_130":153,"_46":175},"treeMembers",[262],{"_228":263,"_232":264,"_234":265,"_12":266},{"_230":231},".vscode/mcp.json","mcp.json","blob","actionData","errors"]

MCP directory API