{
  "markdown": "# Character Counter MCP Server - Python Quickstart\n\nA simple example of creating an MCP server using FastMCP and Python, designed to work with Smithery.\n\n## What This Does\n\nThis server provides a character counter tool called `count_character` that counts how many times a specific character appears in a given text. You'll test it using the Smithery Playground for interactive development.\n\n## Prerequisites\n\n- Python 3.12 or higher\n- A Python package manager ([uv](https://docs.astral.sh/uv/) recommended, but pip, poetry, etc. also work)\n- Node.js and npx (optional, for Smithery Playground)\n\n## Quick Start\n\n1. **Clone the repository:**\n   ```bash\n   git clone https://github.com/smithery-ai/smithery-cookbook.git\n   cd smithery-cookbook/servers/python/quickstart\n   ```\n\n2. **Install dependencies:**\n   \n   **With uv (recommended):**\n   ```bash\n   uv sync\n   ```\n   \n   **With poetry:**\n   ```bash\n   poetry install\n   ```\n   \n   **With pip:**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **Run the server:**\n   \n   You have two options:\n   \n   **Option A: Just run the server**\n   ```bash\n   # With uv\n   uv run smithery dev\n   # or use the shorter script alias:\n   uv run dev\n   \n   # With poetry\n   poetry run smithery dev\n   # or use the shorter script alias:\n   poetry run dev\n   \n   # With pip (after installing dependencies)\n   smithery dev\n   ```\n   This starts the MCP server on `http://localhost:8081` and keeps it running.\n   \n   **Option B: Run server + open playground (recommended for testing)**\n   ```bash\n   # With uv\n   uv run smithery playground\n   # or use the shorter script alias:\n   uv run playground\n   \n   # With poetry\n   poetry run smithery playground\n   # or use the shorter script alias:\n   poetry run playground\n   \n   # With pip (after installing dependencies)\n   smithery playground\n   ```\n   This starts the MCP server AND automatically opens the Smithery Playground in your browser where you can:\n   - Interact with your MCP server in real-time\n   - Test the `count_character` tool with different text and characters\n   - See the complete request/response flow\n   - Debug and iterate on your MCP tools quickly\n\n## Testing the Character Counter\n\nTry asking: **\"How many r's are in strawberry?\"**\n\n4. **Deploy to Smithery:**\n   To deploy your MCP server:\n   - Push your code to GitHub (make sure to include the `smithery.yaml`)\n   - Connect your repository at [https://smithery.ai/new](https://smithery.ai/new)\n\nYour server will be available over HTTP and ready to use with any MCP-compatible client!\n\n## Stopping the Server\n\nPress `Ctrl+C` in the terminal to stop the server.\n",
  "bytes": 2625,
  "sha": "2f5a3062120535e4d163f81302fd862b50c7d40bd077124accda304e519ef71a",
  "repo_slug": "miguelgarzons/mcp-cun",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_smithery_miguelgarzons_mcp_cun_61cfd56c/readme"
}