Upload folder using huggingface_hub

.gitignore

@@ -0,0 +1,136 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller files
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django specific
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask specific
+instance/
+.webassets-cache
+
+# Scrapy
+.scrapy
+
+# Documentation builds
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebooks
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# Environment directories
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# PEP 582
+__pypackages__/
+
+# Celery
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath
+*.sage.py
+
+# IDE / Editor directories
+.idea/
+.vscode/
+*.sublime-project
+*.sublime-workspace
+
+# Spyder
+.spyderproject
+.spyproject
+
+# Rope
+.ropeproject
+
+# mkdocs
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre
+.pyre/
+
+# pytype
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Logs and misc
+*.log
+*.sqlite
+*.db

README.md

@@ -1,12 +1,184 @@
 ---
-title: Gradio Test
-emoji: ⚡
-colorFrom: gray
-colorTo: purple
+title: gradio-test
+app_file: app.py
 sdk: gradio
 sdk_version: 5.42.0
-app_file: app.py
-pinned: false
 ---
+## Gradio MCP Integration
+
+Gradio allows developers to create UIs for their models with just a few lines of Python code. It's particularly useful for:
+
+- Creating demos and prototypes
+- Sharing models with non-technical users
+- Testing and debugging model behavior
+
+With the addition of MCP support, Gradio now offers a straigntforward way to expose AI model capabilities through standardized MCP protocol.
+
+### Preqrequisites
+
+Install Gradio with the MCP extra:
+
+```bash
+pip install "gradio[mcp]"
+```
+
+You'll also need an LLM application that supports tool calling using the MCP protocol, such as Cursor (known as "MCP Hosts").
+
+### Creating a MCP Server with Gradio
+
+1. Set up the virtual environment:
+
+```bash
+python -m venv .venv
+```
+
+2. Start the virtual environment:
+
+```bash
+source .venv/bin/activate
+```
+
+3. Install Gradio with the mcp extra:
+
+```bash
+pip install "gradio[mcp]"
+```
+
+4. Run the Gradio app with the MCP server:
+
+```bash
+python app.py
+```
+
+The server will return something like this:
+
+```bash
+* Running on local URL:  http://127.0.0.1:7860
+* To create a public link, set `share=True` in `launch()`.
+
+🔨 Launching MCP server:
+** Streamable HTTP URL: http://127.0.0.1:7860/gradio_api/mcp/
+* [Deprecated] SSE URL: http://127.0.0.1:7860/gradio_api/mcp/sse
+```
+
+With this setup, your letter counter function is now accessible through:
+
+1. A traditional Gradio web interface for direct human interaction
+2. An MCP Server that can be connected to compatible clients
+
+The MCP server will be accessibile at:
+
+```bash
+http://your-server:port/gradio_api/mcp/sse
+```
+
+#### How It Works Behind the Scenes
+
+When you set 'mcp_server=True' in 'launch()', several things happen:
+
+1. Gradio functions are automatically converted to MCP Tools
+2. Input components map to toll argument schemas
+3. Output components determine the response format
+4. The Gradio server now also listens for MCP protocol messages
+5. JSON-RPC over HTTP+SSE is set up for client-server communication
+
+#### Key Features of the Gradio <> MCP Integration
+
+1. Tool Conversion: Each API endpoint in your Gradio app is automatically converted into an MCP tool with a corresponding name, description, and input schema. To view the tools and schemas, visit 'http://your-server:port/gradio_api/mcp/schema' or go to the "View API" link in the footer of your Gradio app, and then click on "MCP".
+
+- You will see a URL like this:
+  'https://abidlabs-mcp-tools.hf.space/gradio_api/mcp/sse'
+
+- To add this MCP to clients that support SSE (e.g. Cursor, Windsurf, Cline), simply add the following configuration to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "gradio": {
+      "url": "https://abidlabs-mcp-tools.hf.space/gradio_api/mcp/sse"
+    }
+  }
+}
+```
+
+- You can also run the server locally:
+
+```bash
+python app.py
+```
+
+And set up:
+
+```json
+{
+  "mcpServers": {
+    "Gradio MCP Server": {
+      "type": "http",
+      "url": "http://127.0.0.1:7860/gradio_api/mcp/"
+    }
+  }
+}
+```
+
+- The url with 'sse' also works:
+  'http://127.0.0.1:7860/gradio_api/mcp/sse'
+
+- Experimental stdio support: For clients that only support stdio, first install Node.js. Then, you can use the following command:
+
+```json
+{
+  "mcpServers": {
+    "gradio": {
+      "command": "npx",
+      "args": ["mcp-remote", "https://abidlabs-mcp-tools.hf.space/gradio_api/mcp/sse"]
+    }
+  }
+}
+```
+
+NOTE: This configuration did not work on Cursor. The MCP server does not load its tools.
+
+2. Environment Variable Support: There are two ways to enable the MCP server functionality:
+
+- Using the 'mcp_server" parameter in launch():
+
+```python
+demo.launch(mcp_server=True)
+```
+
+- Using environment variables:
+
+```python
+export GRADIO_MCP_SERVER=True
+```
+
+3. File Handling: The server automatically handles file data conversions, including:
+
+- Converting base64-encoded strings to file data
+- Processing image files and returning them in the correct format
+- Managing temporary file storage
+
+It is strongly recommended that input images and files be passed as full URLs ("http://..." or "https://...") as MCP Clients do not always handle local files correctly.
+
+4. Hosted MCP Servers on Hugging Face Spaces: You can publish your Gradio application for free on Hugging Face Spaces, which allow you to have a free hosted MCP server. Here's an example of such a Space: [https://huggingface.co/spaces/abidlabs/mcp-tools](https://huggingface.co/spaces/abidlabs/mcp-tools)
+
+#### Troubleshooting timestamp
+
+1. Type Hints and Docstrings: Ensure you provide type hints and valid docstrings for your functions. The docstring should include "Args:" block with indented parameters names.
+
+2. String Input: When in doubt, accept input arguments as str and covert them to the desired type inside the function.
+
+3. SSE Support: Some MCP Hosts don't support SSE-based MCP Servers. In those cases, you can use mcp-remote:
+
+```json
+{
+  "mcpServers": {
+    "gradio": {
+      "command": "npx",
+      "args": ["mcp-remote", "http://your-server:port/gradio_api/mcp/sse"]
+    }
+  }
+}
+```
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+4. Restart: If you encounter connection issues, try restarting both your MCP Client and MCP Server.

app.py

@@ -0,0 +1,32 @@
+import gradio as gr
+
+
+def letter_counter(word: str, letter: str) -> int:
+    """
+    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:
+        int: The number of times the letter appears in the text
+    """
+    word = word.lower()
+    letter = letter.lower()
+    count = word.count(letter)
+    return count
+
+
+# Create a standard Gradio interface
+demo = gr.Interface(
+    fn=letter_counter,
+    inputs=["textbox", "textbox"],
+    outputs="number",
+    title="Letter Counter",
+    description="Enter text and a letter to count how many times the letter appears in the text."
+)
+
+# Launch both the Gradio web interface and the MCP server
+if __name__ == "__main__":
+    demo.launch(mcp_server=True)

requirements.txt

@@ -0,0 +1,380 @@
+aiofiles==24.1.0
+aiohappyeyeballs==2.4.4
+aiohttp==3.11.11
+aiosignal==1.3.2
+alembic==1.14.0
+annotated-types==0.7.0
+anyio==4.10.0
+appdirs==1.4.4
+apturl==0.5.2
+argcomplete==1.8.1
+argon2-cffi==23.1.0
+argon2-cffi-bindings==21.2.0
+arrow==1.3.0
+asgiref==3.8.1
+asttokens==2.4.1
+async-lru==2.0.4
+async-timeout==4.0.3
+attrs==25.3.0
+auth0-python==4.7.2
+Babel==2.14.0
+backoff==2.2.1
+bcrypt==4.2.1
+beautifulsoup4==4.12.3
+bleach==6.1.0
+blinker==1.4
+Brlapi==0.8.3
+Brotli==1.1.0
+build==1.2.2.post1
+cachetools==5.5.0
+certifi==2025.8.3
+cffi==1.16.0
+chardet==4.0.0
+charset-normalizer==3.3.2
+chroma-hnswlib==0.7.6
+chromadb==0.5.23
+click==8.2.1
+cohere==5.13.4
+colorama==0.4.4
+coloredlogs==15.0.1
+comm==0.2.1
+command-not-found==0.3
+contourpy==1.2.0
+coverage==7.6.0
+crewai==0.86.0
+crewai-tools==0.17.0
+cryptography==43.0.3
+cupshelpers==1.0
+cycler==0.12.1
+dataclasses-json==0.6.7
+dbus-python==1.2.18
+debugpy==1.8.1
+decorator==5.1.1
+defer==1.0.6
+defusedxml==0.7.1
+dell-recovery==0.0.0
+Deprecated==1.2.15
+deprecation==2.1.0
+distlib==0.3.8
+distro==1.7.0
+distro-info==1.1+ubuntu0.2
+docker==7.1.0
+docker-compose==1.29.2
+dockerpty==0.4.1
+docopt==0.6.2
+docstring_parser==0.16
+docx2txt==0.8
+duplicity==0.8.21
+durationpy==0.9
+embedchain==0.1.125
+et_xmlfile==2.0.0
+exceptiongroup==1.2.0
+executing==2.0.1
+fastapi==0.116.1
+fastavro==1.10.0
+fasteners==0.14.1
+fastjsonschema==2.19.1
+ffmpy==0.6.1
+filelock==3.15.4
+filetype==1.2.0
+flatbuffers==24.3.25
+fonttools==4.49.0
+fqdn==1.5.1
+frozenlist==1.5.0
+fsspec==2024.12.0
+future==0.18.2
+google-ai-generativelanguage==0.6.10
+google-api-core==2.24.0
+google-api-python-client==2.156.0
+google-auth==2.37.0
+google-auth-httplib2==0.2.0
+google-cloud-aiplatform==1.75.0
+google-cloud-bigquery==3.27.0
+google-cloud-core==2.4.1
+google-cloud-resource-manager==1.14.0
+google-cloud-storage==2.19.0
+google-crc32c==1.6.0
+google-generativeai==0.8.3
+google-resumable-media==2.7.2
+googleapis-common-protos==1.66.0
+gptcache==0.1.44
+gradio==5.42.0
+gradio_client==1.11.1
+greenlet==3.1.1
+groovy==0.1.2
+grpc-google-iam-v1==0.13.1
+grpcio==1.68.1
+grpcio-status==1.68.1
+grpcio-tools==1.68.1
+gyp==0.1
+h11==0.16.0
+h2==4.1.0
+hf-xet==1.1.7
+hpack==4.0.0
+httpcore==1.0.9
+httplib2==0.20.2
+httptools==0.6.1
+httpx==0.28.1
+httpx-sse==0.4.1
+huggingface-hub==0.34.4
+humanfriendly==10.0
+hyperframe==6.0.1
+idna==3.10
+imaplib2==3.5
+importlib_metadata==8.5.0
+importlib_resources==6.4.5
+iniconfig==2.0.0
+instructor==1.7.0
+ipykernel==6.29.3
+ipython==8.22.1
+ipywidgets==8.1.2
+isoduration==20.11.0
+jedi==0.19.1
+jeepney==0.7.1
+Jinja2==3.1.5
+jiter==0.6.1
+json5==0.9.18
+json_repair==0.32.0
+jsonpatch==1.33
+jsonpickle==4.0.1
+jsonpointer==2.4
+jsonref==1.1.0
+jsonschema==4.25.0
+jsonschema-specifications==2025.4.1
+jupyter==1.0.0
+jupyter-console==6.6.3
+jupyter-events==0.9.0
+jupyter-lsp==2.2.3
+jupyter_client==8.6.0
+jupyter_core==5.7.1
+jupyter_server==2.12.5
+jupyter_server_terminals==0.5.2
+jupyterlab==4.1.2
+jupyterlab_pygments==0.3.0
+jupyterlab_server==2.25.3
+jupyterlab_widgets==3.0.10
+kaggle==1.6.17
+keyring==23.5.0
+kiwisolver==1.4.5
+kubernetes==31.0.0
+lancedb==0.17.0
+langchain==0.3.13
+langchain-cohere==0.3.4
+langchain-community==0.3.13
+langchain-core==0.3.28
+langchain-experimental==0.3.4
+langchain-google-genai==2.0.7
+langchain-openai==0.2.14
+langchain-text-splitters==0.3.4
+langgraph-cli==0.2.5
+langsmith==0.1.147
+language-selector==0.1
+launchpadlib==1.10.16
+lazr.restfulclient==0.14.4
+lazr.uri==1.0.6
+litellm==1.55.9
+livereload==2.6.3
+lockfile==0.12.2
+louis==3.20.0
+macaroonbakery==1.3.1
+Mako==1.1.3
+Markdown==3.3.6
+markdown-it-py==4.0.0
+MarkupSafe==2.0.1
+marshmallow==3.23.2
+matplotlib==3.8.3
+matplotlib-inline==0.1.6
+mcp==1.10.1
+mdurl==0.1.2
+mem0ai==0.1.36
+mistune==3.0.2
+mkdocs==1.1.2
+mmh3==5.0.1
+monotonic==1.6
+more-itertools==8.10.0
+mpmath==1.3.0
+multidict==6.1.0
+mypy-extensions==1.0.0
+nbclient==0.9.0
+nbconvert==7.16.1
+nbformat==5.9.2
+nest-asyncio==1.6.0
+netifaces==0.11.0
+networkx==3.4.2
+nodeenv==1.9.1
+notebook==7.1.1
+notebook_shim==0.2.4
+numpy==1.26.4
+oauthlib==3.2.2
+olefile==0.46
+ollama==0.4.4
+onnxruntime==1.20.1
+openai==1.58.1
+openpyxl==3.1.5
+opentelemetry-api==1.29.0
+opentelemetry-exporter-otlp-proto-common==1.29.0
+opentelemetry-exporter-otlp-proto-grpc==1.29.0
+opentelemetry-exporter-otlp-proto-http==1.29.0
+opentelemetry-instrumentation==0.50b0
+opentelemetry-instrumentation-asgi==0.50b0
+opentelemetry-instrumentation-fastapi==0.50b0
+opentelemetry-proto==1.29.0
+opentelemetry-sdk==1.29.0
+opentelemetry-semantic-conventions==0.50b0
+opentelemetry-util-http==0.50b0
+orjson==3.10.12
+outcome==1.3.0.post0
+overrides==7.7.0
+packaging==23.2
+pandas==2.2.1
+pandocfilters==1.5.1
+parameterized==0.9.0
+paramiko==2.9.3
+parso==0.8.3
+pdfminer.six==20231228
+pdfplumber==0.11.4
+pexpect==4.8.0
+pillow==11.0.0
+pipx==1.0.0
+platformdirs==4.2.0
+pluggy==1.5.0
+portalocker==2.10.1
+posthog==3.7.4
+prometheus_client==0.20.0
+prompt-toolkit==3.0.43
+propcache==0.2.1
+proto-plus==1.25.0
+protobuf==5.29.2
+psutil==5.9.8
+ptyprocess==0.7.0
+pure-eval==0.2.2
+pyarrow==18.1.0
+pyasn1==0.6.1
+pyasn1_modules==0.4.1
+pycairo==1.20.1
+pycparser==2.21
+pycups==2.0.1
+pydantic==2.11.7
+pydantic-settings==2.10.1
+pydantic_core==2.33.2
+pydub==0.25.1
+Pygments==2.19.2
+PyGObject==3.42.1
+pyinotify==0.9.6
+PyJWT==2.10.1
+pylance==0.20.0
+pymacaroons==0.13.0
+PyNaCl==1.5.0
+pyparsing==2.4.7
+pypdf==5.1.0
+pypdfium2==4.30.1
+PyPika==0.48.9
+pyproject_hooks==1.2.0
+PyQt5==5.15.6
+PyQt5-sip==12.9.1
+PyQtWebEngine==5.15.5
+pyRFC3339==1.1
+pyright==1.1.391
+pyrsistent==0.18.1
+pysbd==0.3.4
+PySocks==1.7.1
+pytest==8.2.2
+pytest-cov==5.0.0
+python-apt==2.4.0+ubuntu4
+python-dateutil==2.9.0.post0
+python-debian==0.1.43+ubuntu1.1
+python-dotenv==1.1.1
+python-json-logger==2.0.7
+python-multipart==0.0.20
+python-slugify==8.0.4
+pytube==15.0.0
+pytz==2024.2
+pyvis==0.3.2
+pyxdg==0.27
+PyYAML==6.0.2
+pyzmq==25.1.2
+qdrant-client==1.12.1
+qtconsole==5.5.1
+QtPy==2.4.1
+referencing==0.36.2
+regex==2024.11.6
+reportlab==3.6.8
+requests==2.32.3
+requests-oauthlib==2.0.0
+requests-toolbelt==1.0.0
+rfc3339-validator==0.1.4
+rfc3986-validator==0.1.1
+rich==14.1.0
+rpds-py==0.27.0
+rsa==4.9
+ruff==0.12.9
+safehttpx==0.1.6
+schema==0.7.7
+screen-resolution-extra==0.0.0
+SecretStorage==3.3.1
+selenium==4.27.1
+semantic-version==2.10.0
+Send2Trash==1.8.2
+shapely==2.0.6
+shellingham==1.5.4
+six==1.16.0
+sniffio==1.3.1
+sortedcontainers==2.4.0
+soupsieve==2.5
+SQLAlchemy==2.0.36
+sse-starlette==3.0.2
+stack-data==0.6.3
+starlette==0.47.2
+sympy==1.13.3
+systemd-python==234
+tabulate==0.9.0
+tenacity==9.0.0
+terminado==0.18.0
+text-unidecode==1.3
+texttable==1.6.4
+tiktoken==0.7.0
+tinycss2==1.2.1
+tokenizers==0.20.3
+tomli==2.2.1
+tomli_w==1.1.0
+tomlkit==0.13.3
+tornado==6.4
+tqdm==4.67.1
+traitlets==5.14.1
+trio==0.27.0
+trio-websocket==0.11.1
+typer==0.16.0
+types-python-dateutil==2.8.19.20240106
+types-requests==2.32.0.20241016
+typing-inspect==0.9.0
+typing-inspection==0.4.1
+typing_extensions==4.14.1
+tzdata==2024.1
+ubuntu-drivers-common==0.0.0
+ubuntu-pro-client==8001
+ufw==0.36.1
+unattended-upgrades==0.1
+uri-template==1.3.0
+uritemplate==4.1.1
+urllib3==2.2.3
+usb-creator==0.3.7
+userpath==1.8.0
+uv==0.5.11
+uvicorn==0.35.0
+uvloop==0.19.0
+virtualenv==20.26.3
+wadllib==1.3.6
+watchfiles==0.21.0
+wcwidth==0.2.13
+webcolors==1.13
+webencodings==0.5.1
+websocket-client==1.8.0
+websockets==12.0
+widgetsnbextension==4.0.10
+wrapt==1.17.0
+wsproto==1.2.0
+xdg==5
+xkit==0.0.0
+yamale==6.0.0
+yarl==1.18.3
+zipp==3.21.0