smithery-ai-cookbook-python-quickstart

Character Counter MCP Server - Python クイックスタート

FastMCP と Python を使用して MCP サーバーを作成する、Smithery での動作を想定したシンプルな例です。

このサーバーでできること

このサーバーは、指定したテキストに特定の文字が何回出現するかを数える count_character という文字カウントツールを提供します。インタラクティブな開発には、Smithery Playground を使ってテストします。

前提条件

• Python 3.12 以上
• Python パッケージマネージャー（uv を推奨しますが、pip、poetry なども使用できます）
• Node.js と npx（任意。Smithery Playground 用）

クイックスタート

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

   uv を使用する場合（推奨）：

   uv sync
   

   poetry を使用する場合：

   poetry install
   

   pip を使用する場合：

   pip install -r requirements.txt
   

3. サーバーを起動します：

   次の 2 つの方法があります。

   方法 A：サーバーのみを起動する

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

   MCP サーバーが http://localhost:8081 で起動し、実行状態が維持されます。

   方法 B：サーバーを起動して Playground を開く（テストにおすすめ）

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

   MCP サーバーが起動し、ブラウザーで Smithery Playground が自動的に開きます。そこで次のことができます。

   • MCP サーバーをリアルタイムで操作する
   • テキストや文字を変えて count_character ツールをテストする
   • リクエストとレスポンスの一連の流れを確認する
   • MCP ツールをすばやくデバッグして改善する

文字カウンターをテストする

「strawberry には r がいくつありますか？」 と尋ねてみてください。

4. Smithery にデプロイします： MCP サーバーをデプロイするには：
   • コードを GitHub にプッシュします（smithery.yaml も含めてください）
   • https://smithery.ai/new でリポジトリを接続します

サーバーは HTTP 経由で利用でき、MCP 対応の任意のクライアントですぐに使用できます！

サーバーを停止する

ターミナルで Ctrl+C を押すと、サーバーが停止します。