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. 运行服务：

   有两种方式：

   选项 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
   

   这会在 http://localhost:8081 启动 MCP 服务并使其持续运行。

   选项 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 停止服务。