https://scriptable.com/categories/python/Recent content in Python on scriptable.comHugoenMon, 20 Jul 2026 10:53:05 -0400https://scriptable.com/posts/python/cli-tool-github-uvx-macos/Mon, 20 Jul 2026 10:53:05 -0400https://scriptable.com/posts/python/cli-tool-github-uvx-macos/A sibling article, Publish a FastMCP Server to PyPI and Run It Anywhere with uvx, ships a package to the public PyPI index. This one skips the index entirely. If your code is a Git repository, uvx…https://scriptable.com/posts/python/dockerize-mcp-server-macos/Sat, 18 Jul 2026 22:38:32 -0400https://scriptable.com/posts/python/dockerize-mcp-server-macos/Packaging an MCP server as a Docker image gives clients one launch command with no Python, no uv, and no virtual environment to manage on the host: they run the container. This tutorial builds a…https://scriptable.com/posts/python/ci-cd-mcp-server-macos/Sat, 18 Jul 2026 22:29:52 -0400https://scriptable.com/posts/python/ci-cd-mcp-server-macos/An installable MCP server needs the same release discipline as any Python package: lint and test every change, build the artifact, and publish on a tagged release. This tutorial wires that pipeline…https://scriptable.com/posts/python/mcp-threat-model-hardening-macos/Sat, 18 Jul 2026 22:20:54 -0400https://scriptable.com/posts/python/mcp-threat-model-hardening-macos/An MCP server is an attack surface. It runs with real privileges (a filesystem, API credentials, a database), it accepts arguments chosen by a model that may be under an attacker's influence, and its…https://scriptable.com/posts/python/debug-mcp-server-inspector-macos/Sat, 18 Jul 2026 22:13:12 -0400https://scriptable.com/posts/python/debug-mcp-server-inspector-macos/The [MCP Inspector](https://github.com/modelcontextprotocol/inspector) is the official developer tool for MCP servers. It has two faces: a web UI for clicking through tools, resources, and prompts…https://scriptable.com/posts/python/per-tool-scopes-mcp-macos/Sat, 18 Jul 2026 17:15:08 -0400https://scriptable.com/posts/python/per-tool-scopes-mcp-macos/An email allowlist answers one question: is this caller allowed in at all? Real servers need a second answer: which of my tools may this particular caller use? A reader should be able to list notes…https://scriptable.com/posts/python/testing-strategy-mcp-macos/Sat, 18 Jul 2026 16:49:32 -0400https://scriptable.com/posts/python/testing-strategy-mcp-macos/Most MCP servers get a handful of assert result == ... tests bolted on and nothing more. That misses the failures that actually bite: a tool quietly renamed, a parameter that changed type, a result…https://scriptable.com/posts/python/wrap-local-cli-mcp-macos/Sat, 18 Jul 2026 16:41:50 -0400https://scriptable.com/posts/python/wrap-local-cli-mcp-macos/A command-line tool you already trust makes a good MCP tool: it has a stable interface, it is installed on the box, and its behavior is documented. The work is not reimplementing it, it is exposing…https://scriptable.com/posts/python/mcp-from-fastapi-macos/Sat, 18 Jul 2026 16:31:42 -0400https://scriptable.com/posts/python/mcp-from-fastapi-macos/If you already run a FastAPI service, you do not have to hand-write an MCP tool for each endpoint or maintain a separate OpenAPI file. FastMCP.from_fastapi takes the app object itself, reads the…https://scriptable.com/posts/python/mcp-from-openapi-macos/Sat, 18 Jul 2026 08:12:36 -0400https://scriptable.com/posts/python/mcp-from-openapi-macos/If a service already publishes an OpenAPI spec, you do not have to hand-write a tool for each endpoint. FastMCP.from_openapi reads the spec and generates the whole server: every operation becomes an…https://scriptable.com/posts/python/serve-mcp-resources-macos/Sat, 18 Jul 2026 08:03:57 -0400https://scriptable.com/posts/python/serve-mcp-resources-macos/Resources are the read side of MCP: addressable, cacheable data a client fetches by URI, separate from the tools that take action. Serving them well means more than returning a string. A resource has…https://scriptable.com/posts/python/mcp-prompts-macos/Sat, 18 Jul 2026 07:54:23 -0400https://scriptable.com/posts/python/mcp-prompts-macos/Tools let a model do things; prompts let a user start things. An MCP prompt is a named, parameterized message template a client surfaces as a slash command or a menu entry — the user picks it, fills…https://scriptable.com/posts/python/argument-completions-mcp-server-macos/Sat, 18 Jul 2026 07:38:20 -0400https://scriptable.com/posts/python/argument-completions-mcp-server-macos/When a user fills in a prompt argument or a resource URI in an MCP client, the client can offer autocomplete, the same way a shell completes a path. That only works if the server answers a…https://scriptable.com/posts/python/dynamic-mcp-server-notifications-macos/Sat, 18 Jul 2026 07:20:21 -0400https://scriptable.com/posts/python/dynamic-mcp-server-notifications-macos/Most MCP servers are static: a fixed set of tools and resources, decided at startup. Two features let a server change shape at runtime. Resource templates serve a whole family of resources from one…https://scriptable.com/posts/python/mcp-tool-annotations-semantics-macos/Sat, 18 Jul 2026 07:06:39 -0400https://scriptable.com/posts/python/mcp-tool-annotations-semantics-macos/A working MCP tool is not the same as a well-designed one. A model decides whether to call your tool, and a client decides whether to auto-run it or ask the user first, based entirely on what the…https://scriptable.com/posts/python/structured-output-fastmcp-server-macos/Sat, 18 Jul 2026 06:55:17 -0400https://scriptable.com/posts/python/structured-output-fastmcp-server-macos/A tool that returns only text makes every caller re-parse prose. The model reads "Denver is 21.5°C and clear" and has to extract the number again; a program has to write a regex. MCP's structured…https://scriptable.com/posts/python/mcp-server-vscode-cursor-zed-macos/Fri, 17 Jul 2026 16:49:27 -0400https://scriptable.com/posts/python/mcp-server-vscode-cursor-zed-macos/Two things are common to all three, and to the Claude clients before them:https://scriptable.com/posts/python/publish-mcp-server-pypi-uvx-macos/Fri, 17 Jul 2026 16:12:04 -0400https://scriptable.com/posts/python/publish-mcp-server-pypi-uvx-macos/Two earlier articles bookend this one. Package and Distribute a FastMCP Server as a uvx Tool gets you to uvx macmcp in your own terminal, and Register a FastMCP Server with Claude Desktop and Claude…https://scriptable.com/posts/python/observability-fastmcp-server-macos/Fri, 17 Jul 2026 12:39:40 -0400https://scriptable.com/posts/python/observability-fastmcp-server-macos/A server in production has to answer three questions: is it up, what is it doing, and when something breaks, why. This tutorial adds the three observability pillars to a…https://scriptable.com/posts/python/register-fastmcp-server-with-claude-macos/Fri, 17 Jul 2026 12:21:29 -0400https://scriptable.com/posts/python/register-fastmcp-server-with-claude-macos/You have a working MCP server (see Build an MCP Server with FastMCP and Create and Deploy a FastMCP Server on macOS). A server on its own does nothing until a client connects to it. This tutorial…https://scriptable.com/posts/python/clerk-fastmcp-server-macos/Fri, 17 Jul 2026 11:26:54 -0400https://scriptable.com/posts/python/clerk-fastmcp-server-macos/In Add GitHub OAuth to a FastMCP Server you delegated login to GitHub. That is a good fit when your users already have GitHub accounts, but it ties your server to one social provider. This tutorial…https://scriptable.com/posts/python/uv-workspaces-apps/Fri, 10 Jul 2026 09:57:27 -0400https://scriptable.com/posts/python/uv-workspaces-apps/The [previous tutorial](/posts/python/uv-workspaces/) built a uv workspace with a single packages/ folder holding a library and a CLI. That layout mixes reusable libraries and runnable programs in…https://scriptable.com/posts/python/uv-workspaces/Fri, 10 Jul 2026 09:42:27 -0400https://scriptable.com/posts/python/uv-workspaces/A uv workspace lets several related Python packages live in one repository, share a single lockfile and virtual environment, and depend on each other by name without publishing to a registry. This…https://scriptable.com/posts/python/a2a-agent-to-agent-protocol-macos/Thu, 09 Jul 2026 06:10:59 -0400https://scriptable.com/posts/python/a2a-agent-to-agent-protocol-macos/Most of the MCP articles in this repo connect an agent downward to tools: an agent is a client, and a server exposes functions it can call. That is the vertical axis. The Agent2Agent (A2A) protocol…https://scriptable.com/posts/python/agent-mcp-server-macos/Tue, 07 Jul 2026 21:53:42 -0400https://scriptable.com/posts/python/agent-mcp-server-macos/The earlier MCP articles built servers that expose tools and a client that calls those tools by hand: you name the tool, you supply the arguments. An agent is the piece that makes those decisions for…https://scriptable.com/posts/python/compose-proxy-fastmcp-server-macos/Tue, 07 Jul 2026 16:36:03 -0400https://scriptable.com/posts/python/compose-proxy-fastmcp-server-macos/As an MCP deployment grows, one giant server file stops scaling. [FastMCP](https://gofastmcp.com) offers two ways to build bigger servers from smaller ones:https://scriptable.com/posts/python/elicitation-sampling-fastmcp-server-macos/Tue, 07 Jul 2026 16:12:01 -0400https://scriptable.com/posts/python/elicitation-sampling-fastmcp-server-macos/Most tools take their inputs up front and return an answer. Two MCP capabilities turn that around and let a tool ask the client for something mid-run:https://scriptable.com/posts/python/progress-streaming-fastmcp-server-macos/Tue, 07 Jul 2026 15:57:27 -0400https://scriptable.com/posts/python/progress-streaming-fastmcp-server-macos/A tool that returns in a few milliseconds needs no ceremony. A tool that runs for several seconds does: without feedback, the client looks frozen, and a user (or a model) cannot tell a slow success…https://scriptable.com/posts/python/external-api-fastmcp-server-macos/Tue, 07 Jul 2026 15:31:21 -0400https://scriptable.com/posts/python/external-api-fastmcp-server-macos/The tools in the earlier articles computed their answers locally. Most useful tools instead reach out to an external service: a weather API, a payments provider, an internal microservice. That…https://scriptable.com/posts/python/tls-caddy-fastmcp-server-macos/Tue, 07 Jul 2026 15:22:55 -0400https://scriptable.com/posts/python/tls-caddy-fastmcp-server-macos/Every deployment article so far bound the server to 127.0.0.1 over plain HTTP. That is correct for local use and unusable for anything else: a client on another machine cannot reach loopback, and…https://scriptable.com/posts/python/rate-limit-fastmcp-server-macos/Tue, 07 Jul 2026 15:03:30 -0400https://scriptable.com/posts/python/rate-limit-fastmcp-server-macos/FastMCP ships global and per-client rate limiters, but a quota that varies by plan needs a small custom middleware. You will write one on top of FastMCP's Middleware base and its RateLimitError, back…https://scriptable.com/posts/python/jwt-fastmcp-server-macos/Tue, 07 Jul 2026 14:39:06 -0400https://scriptable.com/posts/python/jwt-fastmcp-server-macos/Two earlier articles secured a [FastMCP](https://gofastmcp.com) server two ways: Gate a FastMCP Server to Paying Customers verified opaque license keys you minted and stored yourself, and Add GitHub…https://scriptable.com/posts/python/oauth-fastmcp-server-macos/Tue, 07 Jul 2026 13:42:50 -0400https://scriptable.com/posts/python/oauth-fastmcp-server-macos/In Gate a FastMCP Server to Paying Customers you minted your own license keys and verified them yourself. That works, but it means you own the hard parts: issuing credentials, storing them, revoking…https://scriptable.com/posts/python/sqlite-fastmcp-server-macos/Tue, 07 Jul 2026 11:55:45 -0400https://scriptable.com/posts/python/sqlite-fastmcp-server-macos/The FastMCP tutorials so far returned pure, stateless results. Real tools usually need state that persists — a record that is still there after the process restarts. In this tutorial you will build a…https://scriptable.com/posts/python/media-fastmcp-server-macos/Tue, 07 Jul 2026 11:33:13 -0400https://scriptable.com/posts/python/media-fastmcp-server-macos/MCP tools usually return text. But a tool can also return media (an image, a document), and sometimes the right answer isn't the bytes at all but a link to them. This tutorial builds a…https://scriptable.com/posts/python/uvx-fastmcp-server-macos/Tue, 07 Jul 2026 11:32:46 -0400https://scriptable.com/posts/python/uvx-fastmcp-server-macos/The friendliest way to ship a Python command-line tool today is to make it runnable with [uvx](https://docs.astral.sh/uv/guides/tools/), uv's equivalent of pipx run. A user types uvx macmcp and uv…https://scriptable.com/posts/python/claude-code-fastmcp-server-macos/Tue, 07 Jul 2026 10:43:47 -0400https://scriptable.com/posts/python/claude-code-fastmcp-server-macos/Most tutorials hand you code to type. This one does the opposite: you will stand up a [FastMCP](https://gofastmcp.com) server on your Mac in which you never write a line of application code. You…https://scriptable.com/posts/python/license-gated-fastmcp-server-macos/Tue, 07 Jul 2026 10:25:19 -0400https://scriptable.com/posts/python/license-gated-fastmcp-server-macos/Building an MCP server is easy; making sure only the people who paid for it can call it is the part that turns a demo into a product. In this tutorial you will build a…https://scriptable.com/posts/python/connect-fastmcp-server-macos/Tue, 07 Jul 2026 10:03:38 -0400https://scriptable.com/posts/python/connect-fastmcp-server-macos/In the companion article Create and Deploy a FastMCP Server on macOS you built a [FastMCP](https://gofastmcp.com) server and deployed it as a launchd service listening on http://127.0.0.1:8000/mcp/…https://scriptable.com/posts/python/deploy-fastmcp-server-macos/Tue, 07 Jul 2026 09:39:26 -0400https://scriptable.com/posts/python/deploy-fastmcp-server-macos/The [Model Context Protocol](https://modelcontextprotocol.io) (MCP) lets AI clients (Claude Desktop, Claude Code, or your own agent) call tools, read resources, and load prompts from an external…https://scriptable.com/posts/python/multi-agent-google-adk/Thu, 25 Jun 2026 22:06:26 -0400https://scriptable.com/posts/python/multi-agent-google-adk/A single LLM agent works well until the job spans several distinct skills. The proven pattern is a coordinator agent that delegates to specialized sub-agents — much like a manager routing work to…https://scriptable.com/posts/python/mcp-client-fastmcp/Thu, 25 Jun 2026 21:55:47 -0400https://scriptable.com/posts/python/mcp-client-fastmcp/A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server exposes tools, resources, and prompts; an MCP client is what connects to that server, discovers those capabilities, and calls…https://scriptable.com/posts/python/mcp-server-fastmcp/Thu, 25 Jun 2026 21:31:32 -0400https://scriptable.com/posts/python/mcp-server-fastmcp/The [Model Context Protocol](https://modelcontextprotocol.io) (MCP) is an open standard that lets AI clients (such as Claude Desktop, Claude Code, or your own agent) call tools, read resources, and…https://scriptable.com/posts/python/hello-world/Wed, 18 Feb 2026 06:26:31 -0500https://scriptable.com/posts/python/hello-world/A minimal Python project that prints a greeting, accepts a name from the command line, includes a pytest test suite, and uses a Makefile to drive common tasks. This tutorial covers project setup with…https://scriptable.com/posts/python/cli-task-manager/Tue, 17 Feb 2026 22:02:56 -0500https://scriptable.com/posts/python/cli-task-manager/A command-line task manager that stores tasks in a local JSON file, supports adding, listing, completing, and deleting tasks, and uses only the Python standard library.