initial

.gitignore

@@ -0,0 +1,290 @@
+# 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/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.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
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# 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
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+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 type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be added to the global gitignore or merged into this project gitignore.  For a PyCharm
+#  project, it is also recommended to add the following directories to the gitignore:
+#     .idea/
+.idea/
+*.iws
+*.iml
+*.ipr
+
+# Visual Studio Code
+.vscode/
+*.code-workspace
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+# Windows
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+*.tmp
+*.temp
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+# Linux
+*~
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+# Gradio specific
+gradio_cached_examples/
+gradio.db
+flagged/
+
+# MCP specific
+*.mcp
+mcp_logs/
+
+# Local configuration files
+config.local.json
+settings.local.json
+.env.local
+
+# Log files
+*.log
+logs/
+
+# Temporary files
+tmp/
+temp/
+*.swp
+*.swo
+*~
+
+# IDE files
+.sublime-project
+.sublime-workspace
+
+# Node.js (if using any npm packages)
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Screenshots and test outputs
+screenshots/
+test_outputs/
+*.png
+*.jpg
+*.jpeg
+*.gif
+*.pdf
+
+# API keys and secrets
+.secrets
+secrets.json
+api_keys.txt
+
+# Database files
+*.db
+*.sqlite
+*.sqlite3

app.py

@@ -1,7 +1,132 @@
 import gradio as gr
 
-def greet(name):
-    return "Hello " + name + "!!"
+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
+    """
+    if not word or not letter:
+        return 0
+    
+    word = word.lower()
+    letter = letter.lower()
+    count = word.count(letter)
+    return count
+
+def word_stats(text: str) -> dict:
+    """
+    Get comprehensive statistics about a text.
+    
+    Args:
+        text (str): The input text to analyze
+        
+    Returns:
+        dict: Statistics including word count, character count, etc.
+    """
+    if not text:
+        return {"words": 0, "characters": 0, "letters": 0, "sentences": 0}
+    
+    words = len(text.split())
+    characters = len(text)
+    letters = sum(1 for c in text if c.isalpha())
+    sentences = text.count('.') + text.count('!') + text.count('?')
+    
+    return {
+        "words": words,
+        "characters": characters,
+        "letters": letters,
+        "sentences": sentences
+    }
+
+# Create a standard Gradio interface with multiple tabs
+with gr.Blocks(title="Text Analysis MCP Server") as demo:
+    gr.Markdown("# Text Analysis Tools")
+    gr.Markdown("This server provides text analysis functions via both web interface and MCP.")
+    
+    with gr.Tab("Letter Counter"):
+        with gr.Row():
+            text_input = gr.Textbox(
+                label="Enter text",
+                placeholder="Type your text here...",
+                lines=3
+            )
+            letter_input = gr.Textbox(
+                label="Enter letter to count",
+                placeholder="e.g., 'a'",
+                max_lines=1
+            )
+        
+        count_output = gr.Number(label="Letter count")
+        count_btn = gr.Button("Count Letters", variant="primary")
+        
+        count_btn.click(
+            fn=letter_counter,
+            inputs=[text_input, letter_input],
+            outputs=count_output
+        )
+    
+    with gr.Tab("Text Statistics"):
+        stats_text_input = gr.Textbox(
+            label="Enter text to analyze",
+            placeholder="Type your text here...",
+            lines=5
+        )
+        stats_output = gr.JSON(label="Text Statistics")
+        stats_btn = gr.Button("Analyze Text", variant="primary")
+        
+        stats_btn.click(
+            fn=word_stats,
+            inputs=stats_text_input,
+            outputs=stats_output
+        )
+    
+    with gr.Tab("MCP Info"):
+        gr.Markdown("""
+        ## MCP Server Information
+        
+        This server is running as an MCP (Model Context Protocol) server.
+        
+        **MCP Endpoint**: `http://127.0.0.1:7860/gradio_api/mcp/sse`
+        
+        **Available Functions**:
+        - `letter_counter`: Count occurrences of a letter in text
+        - `word_stats`: Get comprehensive text statistics
+        
+        **Usage with MCP Client**:
+        ```json
+        {
+            "model": "your-model",
+            "provider": "your-provider",
+            "servers": [
+                {
+                    "type": "sse",
+                    "config": {
+                        "url": "http://127.0.0.1:7860/gradio_api/mcp/sse"
+                    }
+                }
+            ]
+        }
+        ```
+        """)
+
+# Launch both the Gradio web interface and the MCP server
+if __name__ == "__main__":
+    print("🚀 Starting Text Analysis Server...")
+    print("📊 Gradio Interface: http://127.0.0.1:7860")
+    print("🔌 MCP Server: http://127.0.0.1:7860/gradio_api/mcp/sse")
+    print("💡 Use the Gradio interface to test functions")
+    print("🤖 Use the MCP endpoint with tiny-agents or other MCP clients")
+    
+    demo.launch(
+        mcp_server=True,
+        server_name="127.0.0.1",
+        server_port=7860,
+        show_api=True
+    )
 
-demo = gr.Interface(fn=greet, inputs="text", outputs="text")
-demo.launch()

requirements.txt

@@ -0,0 +1,16 @@
+# Core dependencies for Gradio MCP Server
+gradio>=4.44.0
+
+# Optional: For better performance and additional features
+# uvicorn>=0.24.0        # ASGI server for production deployment
+# fastapi>=0.104.0       # Web framework (used by Gradio internally)
+
+# Optional: For development and testing
+# pytest>=7.4.0          # Testing framework
+# black>=23.0.0          # Code formatting
+# flake8>=6.0.0          # Code linting
+
+# Optional: For enhanced text processing
+# nltk>=3.8.0            # Natural language processing
+# spacy>=3.7.0           # Advanced NLP
+# textstat>=0.7.0        # Text readability statistics