[{"_1":2,"_290":-5,"_291":-5},"loaderData",{"_3":4,"_24":25,"_202":203},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":22,"_23":-5},"attributes",[15],"bot","id",27182804,"membership","referenceId","019ab33c-32bd-768e-80e6-9ee61bfabc38","unreadReleaseNotesCount",2,"userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_28":-5,"_29":30,"_31":43,"_120":121,"_201":104},"availableLocales",[],"githubUser","locale",{"_31":32,"_39":40,"_41":42},"mcpServer",{"_33":34,"_35":36,"_37":38},"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",{"_44":45,"_13":46,"_52":34,"_53":34,"_35":36,"_16":54,"_55":56,"_57":58,"_66":-5,"_67":68,"_69":-5,"_70":71,"_110":111,"_115":-5,"_65":95,"_116":68,"_97":117,"_118":119},"addedAt","2025-11-24T02:03:11.230224Z",[47,48,49,50,51],"category:weather-services","category:developer-tools","environment:network","language:python","license_grade:f","descriptionMarkdown","descriptionPlainText",14332,"integrations",[],"namespace",{"_59":60,"_65":64},"owner",{"_61":62},"githubAccount",{"_63":64},"login","sritajkumarpatel","slug","readmeMarkdown","recentUsage",0,"redditPostExternalId","repository",{"_72":73,"_80":81,"_84":85,"_102":-5,"_103":104,"_105":-5,"_106":107},"argumentsJsonSchema",{"_74":75,"_76":77,"_78":79},"properties",{},"required",[],"type","object","githubProject",{"_37":38,"_82":83},"url","https://github.com/sritajkumarpatel/learn_mcp_2025","githubRepository",{"_86":87,"_88":89,"_90":91,"_16":92,"_93":94,"_39":95,"_59":96,"_99":68,"_100":-5,"_101":68},"defaultBranch","main","fullName","sritajkumarpatel/learn_mcp_2025","githubTreeId",3398263,41149,"language","Python","learn_mcp_2025",{"_63":64,"_97":98},"uid","pdfi1vd5q8","recentStargazers","spdxLicense","stargazers","glamaJson","inspectable",false,"npmPackage","supportedPlatforms",[108,109],"WINDOWS","MACOS","scores",{"_112":68,"_113":-5,"_114":-5},"license","quality","security","simpleIcon","toolCount","k4leocy0sj","updatedAt","2025-11-24T02:03:24.558044Z","meta",[122,125,127,134,137,139,142,145,148,151,154,156,159,162,164,166,168,170,172],{"_123":124},"title","Weather Service MCP | Glama",{"_126":34,"_39":33},"content",{"_128":129,"_130":131,"_132":133},"href","https://glama.ai/mcp/servers/@sritajkumarpatel/learn_mcp_2025","rel","canonical","tagName","link",{"_126":36,"_135":136},"property","og:title",{"_126":34,"_135":138},"og:description",{"_126":140,"_135":141},"https://glama.ai/logo.png","og:logo",{"_126":143,"_135":144},"https://glama.ai/mcp/servers/@sritajkumarpatel/learn_mcp_2025/og-image","og:image",{"_126":146,"_135":147},"630","og:image:height",{"_126":149,"_135":150},"1200","og:image:width",{"_126":152,"_135":153},"website","og:type",{"_126":129,"_135":155},"og:url",{"_126":157,"_135":158},"Glama – MCP Hosting Platform","og:site_name",{"_126":160,"_39":161},"summary_large_image","twitter:card",{"_126":157,"_39":163},"twitter:title",{"_126":34,"_39":165},"twitter:description",{"_126":143,"_39":167},"twitter:image",{"_126":146,"_39":169},"twitter:image:height",{"_126":149,"_39":171},"twitter:image:width",{"_173":174},"script:ld+json",{"_175":176,"_177":178},"@context","http://schema.org","@graph",[179],{"_175":180,"_181":182,"_183":184},"https://schema.org","@type","BreadcrumbList","itemListElement",[185,192,195,199],{"_181":186,"_187":188,"_39":189,"_190":191},"ListItem","item","https://glama.ai/","Glama","position",1,{"_181":186,"_187":193,"_39":194,"_190":22},"https://glama.ai/mcp","MCP",{"_181":186,"_187":196,"_39":197,"_190":198},"https://glama.ai/mcp/servers","Servers",3,{"_181":186,"_187":129,"_39":36,"_190":200},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_204":205,"_31":211,"_226":227,"_120":239,"_236":263,"_264":265},"blob",{"_126":206,"_207":208,"_209":210},"[project]\nname = \"learn-mcp-2025\"\nversion = \"0.1.0\"\ndescription = \"Add your description here\"\nreadme = \"README.md\"\nrequires-python = \">=3.13\"\ndependencies = [\n \"mcp[cli]>=1.22.0\",\n]\n","fileName","pyproject.toml","size",185,{"_44":45,"_13":212,"_52":34,"_53":34,"_35":36,"_16":54,"_55":213,"_57":214,"_66":-5,"_67":68,"_69":-5,"_70":217,"_110":225,"_115":-5,"_65":95,"_116":68,"_97":117,"_118":119},[47,48,49,50,51],[],{"_59":215,"_65":64},{"_61":216},{"_63":64},{"_72":218,"_80":221,"_84":222,"_102":-5,"_103":104,"_105":-5,"_106":224},{"_74":219,"_76":220,"_78":79},{},[],{"_37":38,"_82":83},{"_86":87,"_88":89,"_90":91,"_16":92,"_93":94,"_39":95,"_59":223,"_99":68,"_100":-5,"_101":68},{"_63":64,"_97":98},[108,109],{"_112":68,"_113":-5,"_114":-5},"member",{"_228":229,"_232":233,"_234":208,"_90":91,"_235":-5,"_236":208,"_237":238,"_209":210,"_78":204},"commit",{"_230":231},"sha","ee79a92ec25a4b79b0bae7c4467373267b698e38","contentStoredObjectPointerId",20174958,"fullPath","indexable","path","safeToDisplayAsText",true,[240,242,244,246,248,249,250,252,253,254,255,256,257,258,259,260,261,262],{"_123":241},"pyproject.toml | Weather Service MCP | Glama",{"_126":243,"_39":33},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_128":245,"_130":131,"_132":133},"https://glama.ai/mcp/servers/@sritajkumarpatel/learn_mcp_2025/blob/ee79a92ec25a4b79b0bae7c4467373267b698e38/",{"_126":247,"_135":136},"pyproject.toml | Weather Service MCP",{"_126":243,"_135":138},{"_126":140,"_135":141},{"_126":251,"_135":144},"https://glama.ai/generated-images/og?title=pyproject.toml+%7C+Weather+Service+MCP",{"_126":146,"_135":147},{"_126":149,"_135":150},{"_126":152,"_135":153},{"_126":245,"_135":155},{"_126":157,"_135":158},{"_126":160,"_39":161},{"_126":157,"_39":163},{"_126":243,"_39":165},{"_126":251,"_39":167},{"_126":146,"_39":169},{"_126":149,"_39":171},"","treeMembers",[266,270,273,275,278,281,284,287],{"_228":267,"_234":268,"_236":268,"_78":269},{"_230":231},".vscode","tree",{"_228":271,"_234":272,"_236":272,"_78":204},{"_230":231},".gitignore",{"_228":274,"_234":208,"_236":208,"_78":204},{"_230":231},{"_228":276,"_234":277,"_236":277,"_78":204},{"_230":231},".python-version",{"_228":279,"_234":280,"_236":280,"_78":204},{"_230":231},"README.md",{"_228":282,"_234":283,"_236":283,"_78":204},{"_230":231},"requirements.txt",{"_228":285,"_234":286,"_236":286,"_78":204},{"_230":231},"uv.lock",{"_228":288,"_234":289,"_236":289,"_78":204},{"_230":231},"weather.py","actionData","errors"]

MCP directory API