Upload folder using huggingface_hub

.gitignore

@@ -0,0 +1,148 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a script, but they may be committed by
+#  accident.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+.pytest_cache/
+.hypothesis/
+pytestdebug.log
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# PEP 582; __pypackages__ directory
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath files
+*.sage.py
+
+# Environments
+.env
+.venv
+venv/
+ENV/
+env/
+ENV.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# VSCode settings
+.vscode/
+
+# Editor-specific files
+*.swp
+*~
+.DS_Store
+
+# Secrets - add any files containing secrets here
+secrets.py
+.secrets
+*.local
+
+# Logs
+logs/
+*.log
+
+# OS generated files
+.AppleDouble
+.LSOverride
+
+# Thumbnails
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db

.gradio/certificate.pem

@@ -0,0 +1,31 @@
+-----BEGIN CERTIFICATE-----
+MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
+TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
+cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
+WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
+ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
+h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
+0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
+A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
+T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
+B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
+B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
+KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
+OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
+jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
+qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
+rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
+hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
+ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
+3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
+NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
+ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
+TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
+jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
+oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
+4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
+mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
+emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
+-----END CERTIFICATE-----

README.md

@@ -1,12 +1,16 @@
 ---
-title: Huggingface Mcp
-emoji: 🐨
-colorFrom: red
-colorTo: green
+title: huggingface-mcp
+emoji: 💻
+colorFrom: indigo
+colorTo: blue
 sdk: gradio
 sdk_version: 5.33.0
 app_file: app.py
 pinned: false
+license: apache-2.0
+short_description: some huggingface api as a mcp
+tags:
+- mcp-server-track
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

app.py

@@ -0,0 +1,200 @@
+import gradio as gr
+
+from huggingface_hub import list_spaces, whoami, HfFolder
+from huggingface_hub.hf_api import HfHubHTTPError
+
+def list_my_hf_spaces(hf_username_or_org: str):
+    """
+    Lists all Hugging Face Spaces for a given username or organization.
+
+    Args:
+        hf_username_or_org (str): The Hugging Face username or organization name.
+
+    Returns:
+        list: A list of dictionaries, where each dictionary contains details of a space.
+              Suitable for use with gradio.DataFrame. Returns a list with an error
+              message if an issue occurs.
+    """
+    try:
+        print(f"Fetching Hugging Face Spaces for user/org: {hf_username_or_org}") # Server-side log
+        if not hf_username_or_org or not hf_username_or_org.strip():
+            # Return list of lists format for error
+            return [["Error", "Username/Organization cannot be empty.", "-", "-", "-", "-"]]
+
+        spaces_objects = list_spaces(author=hf_username_or_org.strip())
+        
+        if not spaces_objects:
+            # Return list of lists format for no spaces found
+            return [[f"No spaces found for '{hf_username_or_org}'", "Check username/org or authentication.", "-", "-", "-", "-"]]
+
+        spaces_data_list_of_lists = []
+        for space in spaces_objects:
+            row = [
+                f"[{space.id}](https://huggingface.co/spaces/{space.id})",
+                getattr(space, 'author', 'N/A'),
+                str(getattr(space, 'lastModified', 'N/A')),
+                str(getattr(space, 'private', 'N/A')),
+                str(getattr(space, 'gated', 'N/A')),
+                getattr(space, 'sdk', 'N/A')
+            ]
+            spaces_data_list_of_lists.append(row)
+        
+        return spaces_data_list_of_lists
+
+    except Exception as e:
+        error_message = f"An error occurred: {str(e)}. Ensure correct username/org and HF authentication (huggingface-cli login or HF_TOKEN)."
+        print(error_message) # Server-side log
+        # Return list of lists format for exception
+        return [["Error", error_message, "-", "-", "-", "-"]]
+
+
+def list_my_hf_organizations(token: str = None):
+    """
+    Lists organizations the Hugging Face user (identified by the token) is a member of.
+
+    Args:
+        token (str, optional): Hugging Face API token. 
+                               If None or empty, attempts to load token via HfFolder.get_token().
+
+    Returns:
+        list: A list of lists, where each inner list contains an organization name (as a Markdown link).
+              Suitable for use with gradio.DataFrame.
+    """
+    try:
+        if not token: # If token param is None or empty
+            token = HfFolder.get_token()
+        if not token:
+            return [["Error: Not logged in", "Please log in using 'huggingface-cli login'."]]
+        
+        print("Fetching organizations for the authenticated user...") # Server-side log
+        user_info = whoami(token=token)
+        
+        if not user_info or 'orgs' not in user_info:
+            return [["Info", "No organization information found or user data incomplete."]]
+
+        org_list_from_api = user_info.get('orgs', [])
+        if not org_list_from_api:
+            return [["Info", "Authenticated user is not a member of any organizations."]]
+
+        orgs_data = []
+        for org_dict in org_list_from_api:
+            org_name = org_dict.get('name')
+            if org_name:
+                org_link = f"[{org_name}](https://huggingface.co/{org_name})"
+                orgs_data.append([org_link]) # Store as a list containing the Markdown link
+        
+        if not orgs_data:
+             return [["Info", "Found organization entries but no names extracted."]]
+        return orgs_data
+
+    except HfHubHTTPError as e:
+        if e.response.status_code == 401:
+            error_msg = "Authentication error. Please ensure you are logged in ('huggingface-cli login')."
+        else:
+            error_msg = f"API Error: {str(e)}"
+        print(error_msg) # Server-side log
+        return [["Error", error_msg]]
+    except Exception as e:
+        error_message = f"An unexpected error occurred: {str(e)}"
+        print(error_message) # Server-side log
+        return [["Error", error_message]]
+
+
+def list_organization_spaces(org_name: str):
+    """
+    Lists all public Hugging Face Spaces for a given organization.
+
+    Args:
+        org_name (str): The name of the Hugging Face organization.
+
+    Returns:
+        list: A list of lists, where each inner list contains Space details.
+              Suitable for use with gradio.DataFrame.
+              The Space ID is formatted as a Markdown link.
+    """
+    try:
+        if not org_name or not org_name.strip():
+            return [["Error", "Organization name cannot be empty.", "-", "-", "-", "-"]]
+        
+        print(f"Fetching Hugging Face Spaces for organization: {org_name.strip()}") # Server-side log
+        spaces_objects = list_spaces(author=org_name.strip()) # Use author field for organization
+        
+        if not spaces_objects:
+            return [[f"No Spaces found for organization '{org_name.strip()}'", "Organization may not exist or have no public spaces.", "-", "-", "-", "-"]]
+
+        spaces_data_list_of_lists = []
+        for space in spaces_objects:
+            row = [
+                f"[{space.id}](https://huggingface.co/spaces/{space.id})",
+                getattr(space, 'author', 'N/A'),
+                str(getattr(space, 'lastModified', 'N/A')),
+                str(getattr(space, 'private', 'N/A')),
+                str(getattr(space, 'gated', 'N/A')),
+                getattr(space, 'sdk', 'N/A')
+            ]
+            spaces_data_list_of_lists.append(row)
+        
+        return spaces_data_list_of_lists
+
+    except HfHubHTTPError as e:
+        error_msg = f"API Error for organization '{org_name.strip()}': {str(e)}"
+        print(error_msg) # Server-side log
+        return [["Error", error_msg, "-", "-", "-", "-"]]
+    except Exception as e:
+        error_message = f"An unexpected error occurred for organization '{org_name.strip()}': {str(e)}"
+        print(error_message) # Server-side log
+        return [["Error", error_message, "-", "-", "-", "-"]]
+
+
+# Gradio interface for listing Hugging Face Spaces
+hf_spaces_interface = gr.Interface(
+    fn=list_my_hf_spaces,
+    inputs=[gr.Textbox(label="Hugging Face Username or Organization", placeholder="e.g., huggingface, stabilityai, or your_username")],
+    outputs=[gr.DataFrame(
+        headers=["ID", "Author", "Last Modified", "Private", "Gated", "SDK"], 
+        label="Hugging Face Spaces",
+        wrap=True, # Allow text wrapping in cells
+        datatype=["markdown", "str", "str", "str", "str", "str"] # Render first column as Markdown
+    )],
+    title="Hugging Face api as mcp",
+    description="Enter a Hugging Face username or organization to list their public Spaces.",
+    examples=[["huggingface"], ["stabilityai"], ["gradio"]],
+    allow_flagging='never'
+)
+
+hf_orgs_interface = gr.Interface(
+    fn=list_my_hf_organizations,
+    inputs=[gr.Textbox(label="Hugging Face Token (Optional)", placeholder="hf_xxx... or leave blank to use logged-in user", type="password")],
+    outputs=[gr.DataFrame(
+        headers=["My Organization Name"], 
+        label="My Hugging Face Organizations",
+        wrap=True,
+        datatype=["markdown"] # Render column as Markdown
+    )],
+    title="My Hugging Face Organizations Lister",
+    description="Lists the Hugging Face organizations you are a member of. Requires you to be logged in via 'huggingface-cli login'. Get your token from [here](https://huggingface.co/settings/tokens). Click 'Submit' to refresh.",
+    allow_flagging='never'
+)
+
+
+hf_org_spaces_interface = gr.Interface(
+    fn=list_organization_spaces,
+    inputs=[gr.Textbox(label="Organization Name", placeholder="e.g., huggingface, stabilityai")],
+    outputs=[gr.DataFrame(
+        headers=["ID", "Author", "Last Modified", "Private", "Gated", "SDK"], 
+        label="Organization's Hugging Face Spaces",
+        wrap=True,
+        datatype=["markdown", "str", "str", "str", "str", "str"]
+    )],
+    title="List Organization's Spaces",
+    description="Enter a public Hugging Face organization name to list their Spaces.",
+    examples=[["huggingface"], ["stabilityai"], ["google"]],
+    allow_flagging='never'
+)
+
+if __name__ == "__main__":
+    tabbed_demo = gr.TabbedInterface(
+        [hf_spaces_interface, hf_orgs_interface, hf_org_spaces_interface],
+        ["List Spaces by User/Org", "List My Organizations", "List Org Spaces"]
+    )
+    tabbed_demo.launch(mcp_server=True, share=True)

requirements.txt

@@ -0,0 +1,59 @@
+aiofiles==24.1.0
+annotated-types==0.7.0
+anyio==4.9.0
+certifi==2025.4.26
+charset-normalizer==3.4.2
+click==8.2.1
+fastapi==0.115.12
+ffmpy==0.6.0
+filelock==3.18.0
+fsspec==2025.5.1
+gradio==5.33.0
+gradio_client==1.10.2
+groovy==0.1.2
+h11==0.16.0
+hf-xet==1.1.3
+httpcore==1.0.9
+httpx==0.28.1
+httpx-sse==0.4.0
+huggingface-hub==0.32.4
+idna==3.10
+Jinja2==3.1.6
+markdown-it-py==3.0.0
+MarkupSafe==3.0.2
+mcp==1.9.0
+mdurl==0.1.2
+numpy==2.2.6
+orjson==3.10.18
+packaging==25.0
+pandas==2.2.3
+pillow==11.2.1
+pydantic==2.11.5
+pydantic-settings==2.9.1
+pydantic_core==2.33.2
+pydub==0.25.1
+Pygments==2.19.1
+python-dateutil==2.9.0.post0
+python-dotenv==1.1.0
+python-multipart==0.0.20
+pytz==2025.2
+PyYAML==6.0.2
+requests==2.32.3
+rich==14.0.0
+ruff==0.11.12
+safehttpx==0.1.6
+semantic-version==2.10.0
+shellingham==1.5.4
+six==1.17.0
+sniffio==1.3.1
+sse-starlette==2.3.6
+starlette==0.46.2
+tomlkit==0.13.2
+tqdm==4.67.1
+typer==0.16.0
+typing-inspection==0.4.1
+typing_extensions==4.14.0
+tzdata==2025.2
+urllib3==2.4.0
+uvicorn==0.34.3
+websockets==15.0.1