scriptable.com

Running a Local Package Registry on macOS: Rating the Options for npm, Python, and More

Mon, 20 Jul 2026 10:54:04 -0400

You want a package registry running on your own Mac. The reasons are usually one of these: hosting private packages that should not go to a public index, rehearsing a publish before it becomes…

Build a Python CLI Tool and Distribute It on GitHub with uvx

Mon, 20 Jul 2026 10:53:05 -0400

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…

Dockerize an MCP Server on macOS

Sat, 18 Jul 2026 22:38:32 -0400

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…

CI/CD for an MCP Server: Lint, Test, Build, and Publish with GitHub Actions on macOS

Sat, 18 Jul 2026 22:29:52 -0400

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…

Harden an MCP Server: A Threat Model and Defenses on macOS

Sat, 18 Jul 2026 22:20:54 -0400

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…

Debug an MCP Server with the MCP Inspector on macOS

Sat, 18 Jul 2026 22:13:12 -0400

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…

Build an MCP Server in Rust with the Official SDK

Sat, 18 Jul 2026 22:03:17 -0400

This is the Rust companion to Build an MCP Server in Go with the Official SDK and Build an MCP Server in TypeScript with the Official SDK. It builds the same kind of server — two tools and a resource…

Fine-Grained Authorization for a FastMCP Server on macOS

Sat, 18 Jul 2026 17:15:08 -0400

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…

A Testing Strategy for MCP Servers on macOS

Sat, 18 Jul 2026 16:49:32 -0400

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…

Wrap a Local CLI as MCP Tools on macOS

Sat, 18 Jul 2026 16:41:50 -0400

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…

Expose an Existing FastAPI App as MCP on macOS

Sat, 18 Jul 2026 16:31:42 -0400

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…

Generate an MCP Server from an OpenAPI Spec on macOS

Sat, 18 Jul 2026 08:12:36 -0400

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…

Serve Resources Well from an MCP Server on macOS

Sat, 18 Jul 2026 08:03:57 -0400

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…

Design MCP Prompts: Arguments, Templates, and Embedded Resources on macOS

Sat, 18 Jul 2026 07:54:23 -0400

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…

Add Argument Completions to an MCP Server on macOS

Sat, 18 Jul 2026 07:38:20 -0400

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…

Build a Dynamic MCP Server: Notifications and Resource Templates on macOS

Sat, 18 Jul 2026 07:20:21 -0400

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…

Design Great MCP Tools: Annotations and Semantics on macOS

Sat, 18 Jul 2026 07:06:39 -0400

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…

Return Structured Output from a FastMCP Server on macOS

Sat, 18 Jul 2026 06:55:17 -0400

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…

Use Your MCP Server from VS Code, Cursor, and Zed on macOS

Fri, 17 Jul 2026 16:49:27 -0400

Two things are common to all three, and to the Claude clients before them:

Publish a FastMCP Server to PyPI and Run It Anywhere with uvx

Fri, 17 Jul 2026 16:12:04 -0400

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…

Build an MCP Server in Go with the Official SDK

Fri, 17 Jul 2026 15:08:03 -0400

This is the Go companion to Build an MCP Server in TypeScript with the Official SDK. It builds the same kind of server — two tools and a resource — with the official Go SDK…

Build an MCP Server in TypeScript with the Official SDK

Fri, 17 Jul 2026 14:40:47 -0400

The FastMCP tutorials in this series are Python, and FastMCP wraps the Model Context Protocol so you rarely touch it directly. This article drops down a level and builds the same kind of server with…

Deploy an MCP Server to Cloudflare Workers

Fri, 17 Jul 2026 13:50:41 -0400

The FastMCP tutorials in this series deploy to a Mac with launchd: one machine, your machine, awake and on the network. This one takes the opposite approach and deploys an MCP server to Cloudflare…

Add Observability to a FastMCP Server on macOS

Fri, 17 Jul 2026 12:39:40 -0400

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…

Register a FastMCP Server with Claude Desktop and Claude Code on macOS

Fri, 17 Jul 2026 12:21:29 -0400

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…

Secure a FastMCP Server with Clerk on macOS

Fri, 17 Jul 2026 11:26:54 -0400

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…

Distribute a Claude Code Plugin That Installs an External MCP Server

Wed, 15 Jul 2026 10:34:37 -0400

Sometimes the MCP server you want your team to use already exists — published to a registry, a GitHub repo, or a container image by someone else. You do not need to fork it or vendor its source into…

Bundle an MCP Server in a Claude Code Plugin

Wed, 15 Jul 2026 09:55:10 -0400

A Claude Code plugin can ship an MCP server the same way it ships a command or a hook: drop a .mcp.json at the plugin root, and Claude Code starts the server for anyone who installs the plugin. The…

Create and Distribute a Claude Code Plugin

Wed, 15 Jul 2026 09:38:12 -0400

A Claude Code plugin is a directory with a .claude-plugin/plugin.json manifest that bundles the things you would otherwise drop into ~/.claude/ by hand: slash commands, subagents, hooks, skills, and…

Package and Distribute Skills for Claude Code

Sun, 12 Jul 2026 06:38:38 -0400

A Claude Code skill is a SKILL.md file plus optional supporting files that teach Claude a repeatable procedure. Kept in ~/.claude/skills/ or a project's .claude/skills/, a skill is personal or…

Add an apps/ Folder to a uv Workspace: A Simple App and a FastAPI App

Fri, 10 Jul 2026 09:57:27 -0400

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…

Create a Python uv Workspace with a Shared Makefile

Fri, 10 Jul 2026 09:42:27 -0400

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…

Let Agents Talk to Each Other with the A2A Protocol on macOS

Thu, 09 Jul 2026 06:10:59 -0400

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…

Gate a Premium Folder on a Hugo Site with Stripe and Cloudflare Workers

Tue, 07 Jul 2026 23:43:34 -0400

Build a Hugo static site whose /premium/ section is locked behind a Stripe subscription, with the access decision made by a Cloudflare Worker at the edge. Free posts stay cached and public. A request…

Marketing Studio Ad References: Recreate a Proven Ad Around Your Own Product

Tue, 07 Jul 2026 22:41:11 -0400

There are two ways to structure a UGC video ad in Higgsfield's Marketing Studio. The [hooks and settings](/posts/higgsfield/marketing-studio-hooks-settings/) path lets you assemble a concept from…

Marketing Studio Hooks and Settings: The Two Levers Behind a Scroll-Stopping UGC Ad

Tue, 07 Jul 2026 22:34:01 -0400

When you generate a UGC-style ad video in Higgsfield's Marketing Studio, the preset picks the genre — Unboxing, Tutorial, Selfie Testimonial — but two optional levers control the specifics of the…

How Higgsfield Does Marketing Studio and DTC Ads: Product In, Scroll-Ready Ads Out

Tue, 07 Jul 2026 22:30:00 -0400

Marketing Studio is the one part of Higgsfield built around a commercial goal rather than a raw generation. You point it at a product — or a whole website — and it produces scroll-ready ad images and…

How Higgsfield Does Avatars and Soul Training: One Identity, Two Ways

Tue, 07 Jul 2026 22:25:17 -0400

AI image models reinvent a face every time you generate. The moment you want the same person or character to appear across many images and clips, you need an avatar: a reusable identity you attach to…

How Higgsfield Does Audio and Voice: Speech, Cloning, and Revoicing

Tue, 07 Jul 2026 22:22:37 -0400

Higgsfield's standalone audio is about one thing: voice. It turns text into spoken audio, lets you clone a voice from a sample, and lets you revoice an existing clip with a different speaker. That is…

How Higgsfield Does Video Generation: Short Clips, Many Models, Native Audio

Tue, 07 Jul 2026 22:20:05 -0400

Video is where Higgsfield spends its compute. Like images, it is not one model but a large catalog — Google's Veo and Gemini Omni, Kling, Bytedance's Seedance, xAI's Grok, Minimax, Wan, plus…

How Higgsfield Does Image Generation: One Call, Dozens of Models

Tue, 07 Jul 2026 22:17:34 -0400

Image generation is the foundation of Higgsfield. It is the cheapest and fastest thing the platform makes, and it is the seed for almost everything else: the videos, the 3D models, and the explainer…

How Higgsfield Does 3D: Images In, Rigged Models Out

Tue, 07 Jul 2026 22:14:48 -0400

Most of what Higgsfield makes is flat — images and video. Its 3D tools do something different: they turn a picture (or a text description) into an actual 3D model you can download, open in Blender or…

Getting Started with Higgsfield: How the Whole Thing Fits Together

Tue, 07 Jul 2026 22:11:03 -0400

[Higgsfield](https://higgsfield.ai) is an AI studio for making images, video, voiceover, and 3D. Open it for the first time and it can look like a wall of model names, presets, and buttons, with no…

Turn a Script into a YouTube Video with Higgsfield MCP and Claude Code

Tue, 07 Jul 2026 22:05:31 -0400

[Higgsfield](https://higgsfield.ai) ships a bundled video-explainer workflow through its MCP server: hand it a script and it produces a narrated, animated video by generating one 10-second clip per…

Create YouTube Shorts with the Higgsfield MCP

Tue, 07 Jul 2026 22:00:02 -0400

[Higgsfield](https://higgsfield.ai) exposes its image and video generation as an MCP server, so you can produce short-form video by chatting with an MCP client instead of clicking around a web app or…

Build an Agent That Calls Your MCP Server on macOS

Tue, 07 Jul 2026 21:53:42 -0400

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…

Compose and Proxy FastMCP Servers on macOS

Tue, 07 Jul 2026 16:36:03 -0400

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:

Elicitation and Sampling: Let a FastMCP Tool Ask the Client on macOS

Tue, 07 Jul 2026 16:12:01 -0400

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:

Stream Progress from a Long-Running FastMCP Tool on macOS

Tue, 07 Jul 2026 15:57:27 -0400

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…

Call an External API from a FastMCP Tool on macOS

Tue, 07 Jul 2026 15:31:21 -0400

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…

Put a FastMCP Server Behind HTTPS with Caddy on macOS

Tue, 07 Jul 2026 15:22:55 -0400

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…

Add Per-Plan Rate Limiting to a FastMCP Server on macOS

Tue, 07 Jul 2026 15:03:30 -0400

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…

Verify Signed JWTs with JWKS in a FastMCP Server on macOS

Tue, 07 Jul 2026 14:39:06 -0400

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…

Add GitHub OAuth to a FastMCP Server on macOS

Tue, 07 Jul 2026 13:42:50 -0400

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…

Build a Stateful FastMCP Server on macOS with SQLite

Tue, 07 Jul 2026 11:55:45 -0400

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…

Serve Media from a FastMCP Server on macOS — Inline or as Expiring Links

Tue, 07 Jul 2026 11:33:13 -0400

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…

Package and Distribute a FastMCP Server as a uvx Tool on macOS

Tue, 07 Jul 2026 11:32:46 -0400

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…

Build and Deploy a FastMCP Server on macOS Without Writing Code — Let Claude Code Do It

Tue, 07 Jul 2026 10:43:47 -0400

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…

Gate a FastMCP Server to Paying Customers on macOS

Tue, 07 Jul 2026 10:25:19 -0400

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…

Connect to a FastMCP Server from macOS

Tue, 07 Jul 2026 10:03:38 -0400

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/…

Create and Deploy a FastMCP Server on macOS

Tue, 07 Jul 2026 09:39:26 -0400

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…

Build a Multi-Agent System with Google's Agent Development Kit

Thu, 25 Jun 2026 22:06:26 -0400

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…

Build an MCP Client with FastMCP and Python

Thu, 25 Jun 2026 21:55:47 -0400

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…

Build an MCP Server with FastMCP and Python

Thu, 25 Jun 2026 21:31:32 -0400

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…

Build a Rust Hello World Application

Wed, 18 Feb 2026 06:47:53 -0500

A minimal Rust project that prints a greeting, accepts a name from the command line, includes a test suite, and uses a Makefile to drive common tasks. This tutorial covers project setup with Cargo…

Build a TypeScript Hello World Application

Wed, 18 Feb 2026 06:39:43 -0500

A minimal TypeScript project that prints a greeting, accepts a name from the command line, includes a test suite using Vitest, and uses a Makefile to drive common tasks. This tutorial covers project…

Build a Go Hello World Application

Wed, 18 Feb 2026 06:35:04 -0500

A minimal Go project that prints a greeting, accepts a name from the command line, includes a test suite, and uses a Makefile to drive common tasks. This tutorial covers project structure, flag…

Build a Python Hello World Application

Wed, 18 Feb 2026 06:26:31 -0500

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…

Build a CLI Task Manager in Python

Tue, 17 Feb 2026 22:02:56 -0500

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.

Build a REST API in Go

Tue, 17 Feb 2026 22:02:56 -0500

A JSON REST API for managing a book collection using only the Go standard library. The API supports full CRUD operations, uses Go 1.22 method-based routing, and includes an in-memory store protected…

Build a WebSocket Chat Server in TypeScript

Tue, 17 Feb 2026 22:02:56 -0500

A real-time chat server using WebSockets, built with TypeScript and the ws library on Node.js. The server supports named users, broadcasts messages to all connected clients, tracks join/leave events…

About

Mon, 01 Jan 0001 00:00:00 +0000

Hi, I’m Mitch Allen. I write scriptable.com — hands-on, implementation-focused tutorials for software engineers. Each one is built and run before it is written up, so the commands and code you see are the commands and code that actually worked.

For more of my work, projects, and writing, head to mitchallen.com, or find me on GitHub.