Skip to content

Fix FastMCP constructor for current mcp versions and remove PyPI install instructions#11

Open
bmoeskau wants to merge 2 commits into
excelsier:sourcefrom
bmoeskau:fix/fastmcp-init-and-pypi-readme
Open

Fix FastMCP constructor for current mcp versions and remove PyPI install instructions#11
bmoeskau wants to merge 2 commits into
excelsier:sourcefrom
bmoeskau:fix/fastmcp-init-and-pypi-readme

Conversation

@bmoeskau

Copy link
Copy Markdown

Summary

Two related fixes that together get the server running again from a fresh clone:

  1. FastMCP(...) constructor crash on startup. With mcp >= ~1.10, FastMCP.__init__() no longer accepts description= or version= kwargs, so the server crashes on import:

    TypeError: FastMCP.__init__() got an unexpected keyword argument 'description'
    

    Replaced with the modern instructions= parameter; version is now read automatically from the installed mcp package metadata.

  2. README points at a PyPI package that doesn't publish this fork. "Option 1: Install from PyPI" tells users to pip install things-mcp, but that name resolves to the upstream hald/things-mcp package on PyPI — not this fork — so users following the README either get the wrong code or (per PyPi project 'mcp-things' does not exist #7) hit a name that doesn't exist at all. Removed Option 1 entirely and promoted "Manual Installation" as the single supported path until/unless this fork is published.

Test plan

  • Fresh clone + uv venv && uv pip install -e . + run things_fast_server.py — server starts and responds to a JSON-RPC initialize request
  • Connects successfully as an MCP server in Claude Code
  • get-inbox and get-today tools return data from a live Things 3 install

Closes #7.

description= and version= were removed from FastMCP.__init__(); the
modern equivalent is instructions=, with version read from the mcp
package metadata. Without this, the server crashes on import.
This fork is not published to PyPI. The pip install things-mcp
instructions resolve to the unrelated upstream hald/things-mcp
package. Removing Option 1 until/unless this fork is published.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

PyPi project 'mcp-things' does not exist

1 participant