Smithery Ai Cookbook Python Quickstart

ai.smitheryPublished by smithery.aiOfficial publisherv1.13.1Updated Oct 24, 2026

A simple MCP server built with FastMCP and python

The publisher's own server: 222wcnm Bilistalkermcp

VerifiedStreamable HTTPWeb executableDeveloper Tools

Overview

AI-generated overview

A minimal FastMCP/Python sample server exposing one character-counting tool, hosted on Smithery as a remote endpoint.

What you can do
  • Count characters in text: the single count_character tool reports how many times a given character appears in a supplied string.
  • Serve as a teaching example: the README walks through building, running and deploying a FastMCP server with Smithery, including a local playground for testing requests and responses.
When to use it
Useful mainly as a reference or smoke test when learning how FastMCP servers are built and deployed on Smithery, or to verify that an MCP client can connect to a remote endpoint. It offers no real-world data or workflow value beyond that.
Requirements
A remote streamable HTTP endpoint at server.smithery.ai, with a bearer token supplied in the Authorization header. Running the example locally instead needs Python 3.12 or newer, a Python package manager such as uv, and optionally Node.js with npx for the Smithery Playground.
Before you install
Authentication is required: the Authorization bearer token is a secret and should be kept out of shared configuration. The tool only reads the text you pass in, but any text sent to the hosted endpoint leaves your machine.

Installation

In SourceWeft

  1. Open Smithery Ai Cookbook Python Quickstart in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.smithery%2Fsmithery-ai-cookbook-python-quickstart/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "smithery-ai-cookbook-python-quickstart": {
      "type": "http",
      "url": "https://server.smithery.ai/@smithery-ai/cookbook-python-quickstart/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Character Counter MCP Server - Python Quickstart

A simple example of creating an MCP server using FastMCP and Python, designed to work with Smithery.

What This Does

This 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.

Prerequisites

  • Python 3.12 or higher
  • A Python package manager (uv recommended, but pip, poetry, etc. also work)
  • Node.js and npx (optional, for Smithery Playground)

Quick Start

  1. Clone the repository:

    bash
    git clone https://github.com/smithery-ai/smithery-cookbook.gitcd smithery-cookbook/servers/python/quickstart

  2. Install dependencies:

    With uv (recommended):

    bash
    uv sync

    With poetry:

    bash
    poetry install

    With pip:

    bash
    pip install -r requirements.txt

  3. Run the server:

    You have two options:

    Option A: Just run the server

    bash
    # With uvuv run smithery dev# or use the shorter script alias:uv run dev
# With poetrypoetry run smithery dev# or use the shorter script alias:poetry run dev
# With pip (after installing dependencies)smithery dev

    This starts the MCP server on http://localhost:8081 and keeps it running.

    Option B: Run server + open playground (recommended for testing)

    bash
    # With uvuv run smithery playground# or use the shorter script alias:uv run playground
# With poetrypoetry run smithery playground# or use the shorter script alias:poetry run playground
# With pip (after installing dependencies)smithery playground

    This starts the MCP server AND automatically opens the Smithery Playground in your browser where you can:

    • Interact with your MCP server in real-time
    • Test the count_character tool with different text and characters
    • See the complete request/response flow
    • Debug and iterate on your MCP tools quickly

Testing the Character Counter

Try asking: "How many r's are in strawberry?"

  1. Deploy to Smithery: To deploy your MCP server:
    • Push your code to GitHub (make sure to include the smithery.yaml)
    • Connect your repository at https://smithery.ai/new

Your server will be available over HTTP and ready to use with any MCP-compatible client!

Stopping the Server

Press Ctrl+C in the terminal to stop the server.

Source: servers/python/quickstart/README.md at commit 2bf1e95

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.13.1LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Smithery integrations

222wcnm Bilistalkermcp

ai.smitheryOfficial publisher

Bilibili creator analysis server that lets an assistant look up a specific user's profile, videos, dynamics, articles, subtitles, followings and comments.

Streamable HTTPWeb executable
Knowledge & MemoryNot indexed yetOct 24, 2026

Zwldarren Akshare One Mcp

ai.smitheryOfficial publisher

Remote MCP server that gives an assistant read-only access to Chinese stock market data: historical and real-time prices, news, and financial statements.

Streamable HTTPWeb executableAuth
FinanceCredential requiredOct 24, 2026

Zhaoganghao Hellomcp

ai.smitheryOfficial publisher

A small remote MCP server that lets an assistant greet people by name and share background on the origin of 'Hello, World'.

Streamable HTTPWeb executable
Not indexed yetOct 24, 2026

Zeta Chain Cli

ai.smitheryOfficial publisher

A remote MCP server that lets an assistant generate friendly, customizable greetings for any name or audience.

Streamable HTTPWeb executableAuth
Credential requiredOct 24, 2026

Yuna0x0 Hackmd Mcp

ai.smitheryOfficial publisher

An MCP server that connects an assistant to the HackMD API so it can read, create, update and delete HackMD notes and manage teams.

Streamable HTTPWeb executable
Communication & CollaborationNot indexed yetOct 25, 2026