π The fast, Pythonic way to build MCP servers and clients.
Pin Cyclopts to v4.0.0 + compliance note (#2354)
Jeremiah Lowindcfd9ee387ef
diff --git a/README.md b/README.mdindex 851837894..ca00ef3d0 100644--- a/README.md+++ b/README.md@@ -143,6 +143,8 @@ uv pip install fastmcpFor full installation instructions, including verification, upgrading from the official MCPSDK, and developer setup, see the [**Installation Guide**](https://gofastmcp.com/getting-started/installation).+**Dependency Licensing:** FastMCP depends on Cyclopts for CLI functionality. Cyclopts v4 includes docutils as a transitive dependency, which has complex licensing that may trigger compliance reviews in some organizations. If this is a concern, you can install Cyclopts v5 alpha (`pip install "cyclopts>=5.0.0a1"`) which removes this dependency, or wait for the stable v5 release. See [this issue](https://github.com/BrianPugh/cyclopts/issues/672) for details.+## Core ConceptsThese are the building blocks for creating MCP servers and clients with FastMCP.diff --git a/docs/getting-started/installation.mdx b/docs/getting-started/installation.mdxindex 8da0df91c..edcaa5983 100644--- a/docs/getting-started/installation.mdx+++ b/docs/getting-started/installation.mdx@@ -42,6 +42,20 @@ Python version: 3.12.2Platform: macOS-15.3.1-arm64-arm-64bitFastMCP root path: ~/Developer/fastmcp```++### Dependency Licensing++<Info>+FastMCP depends on Cyclopts for CLI functionality. Cyclopts v4 includes docutils as a transitive dependency, which has complex licensing that may trigger compliance reviews in some organizations.++If this is a concern, you can install Cyclopts v5 alpha which removes this dependency:++```bash+pip install "cyclopts>=5.0.0a1"+```++Alternatively, wait for the stable v5 release. See [this issue](https://github.com/BrianPugh/cyclopts/issues/672) for details.+</Info>## Upgrading from the Official MCP SDKUpgrading from the official MCP SDK's FastMCP 1.0 to FastMCP 2.0 is generally straightforward. The core server API is highly compatible, and in many cases, changing your import statement from `from mcp.server.fastmcp import FastMCP` to `from fastmcp import FastMCP` will be sufficient.diff --git a/pyproject.toml b/pyproject.tomlindex 627a5a704..e20f60047 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -11,7 +11,7 @@ dependencies = ["openapi-pydantic>=0.5.1","platformdirs>=4.0.0","rich>=13.9.4",- "cyclopts>=3.0.0",+ "cyclopts>=4.0.0","authlib>=1.6.5","pydantic[email]>=2.11.7","pyperclip>=1.9.0",diff --git a/uv.lock b/uv.lockindex 96f3468ef..73ec69012 100644--- a/uv.lock+++ b/uv.lock@@ -411,18 +411,19 @@ wheels = [[[package]]name = "cyclopts"-version = "3.22.5"+version = "4.2.1"source = { registry = "https://pypi.org/simple" }dependencies = [{ name = "attrs" },- { name = "docstring-parser", marker = "python_full_version < '4'" },+ { name = "docstring-parser" },{ name = "rich" },{ name = "rich-rst" },+ { name = "tomli", marker = "python_full_version < '3.11'" },{ name = "typing-extensions", marker = "python_full_version < '3.11'" },]-sdist = { url = "https://files.pythonhosted.org/packages/a3/d5/24c6c894f3833bc93d4944c2064309dfd633c0becf93e16fc79d76edd388/cyclopts-3.22.5.tar.gz", hash = "sha256:fa2450b9840abc41c6aa37af5eaeafc7a1264e08054e3a2fe39d49aa154f592a", size = 74890, upload-time = "2025-07-31T18:18:37.336Z" }+sdist = { url = "https://files.pythonhosted.org/packages/8a/51/a67b17fac2530d22216a335bd10f48631412dd824013ea559ec236668f76/cyclopts-4.2.1.tar.gz", hash = "sha256:49bb4c35644e7a9658f706ade4cf1a9958834b2dca4425e2fafecf8a0537fac7", size = 148693, upload-time = "2025-10-31T14:30:58.681Z" }wheels = [- { url = "https://files.pythonhosted.org/packages/df/e5/a7b6db64f08cfe065e531ec6b508fa7dac704fab70d05adb5bc0c2c1d1b6/cyclopts-3.22.5-py3-none-any.whl", hash = "sha256:92efb4a094d9812718d7efe0bffa319a19cb661f230dbf24406c18cd8809fb82", size = 84994, upload-time = "2025-07-31T18:18:35.939Z" },+ { url = "https://files.pythonhosted.org/packages/4d/1d/2b313e157c9c7bba319e42f464d15073d32a81ac4827bdc5b7de38832b3e/cyclopts-4.2.1-py3-none-any.whl", hash = "sha256:17a801faa814988b0307385ef8aaeb6b14b4d64473015a2d66bde9ea13f14d9c", size = 184333, upload-time = "2025-10-31T14:30:57.581Z" },][[package]]@@ -481,11 +482,11 @@ wheels = [[[package]]name = "docutils"-version = "0.22"+version = "0.22.2"source = { registry = "https://pypi.org/simple" }-sdist = { url = "https://files.pythonhosted.org/packages/e9/86/5b41c32ecedcfdb4c77b28b6cb14234f252075f8cdb254531727a35547dd/docutils-0.22.tar.gz", hash = "sha256:ba9d57750e92331ebe7c08a1bbf7a7f8143b86c476acd51528b042216a6aad0f", size = 2277984, upload-time = "2025-07-29T15:20:31.06Z" }+sdist = { url = "https://files.pythonhosted.org/packages/4a/c0/89fe6215b443b919cb98a5002e107cb5026854ed1ccb6b5833e0768419d1/docutils-0.22.2.tar.gz", hash = "sha256:9fdb771707c8784c8f2728b67cb2c691305933d68137ef95a75db5f4dfbc213d", size = 2289092, upload-time = "2025-09-20T17:55:47.994Z" }wheels = [- { url = "https://files.pythonhosted.org/packages/44/57/8db39bc5f98f042e0153b1de9fb88e1a409a33cda4dd7f723c2ed71e01f6/docutils-0.22-py3-none-any.whl", hash = "sha256:4ed966a0e96a0477d852f7af31bdcb3adc049fbb35ccba358c2ea8a03287615e", size = 630709, upload-time = "2025-07-29T15:20:28.335Z" },+ { url = "https://files.pythonhosted.org/packages/66/dd/f95350e853a4468ec37478414fc04ae2d61dad7a947b3015c3dcc51a09b9/docutils-0.22.2-py3-none-any.whl", hash = "sha256:b0e98d679283fc3bb0ead8a5da7f501baa632654e7056e9c5846842213d674d8", size = 632667, upload-time = "2025-09-20T17:55:43.052Z" },][[package]]@@ -614,7 +615,7 @@ dev = [[package.metadata]requires-dist = [{ name = "authlib", specifier = ">=1.6.5" },- { name = "cyclopts", specifier = ">=3.0.0" },+ { name = "cyclopts", specifier = ">=4.0.0,<5.0.0" },{ name = "exceptiongroup", specifier = ">=1.2.2" },{ name = "httpx", specifier = ">=0.28.1" },{ name = "jsonschema-path", specifier = ">=0.3.4" },@@ -1775,15 +1776,15 @@ wheels = [[[package]]name = "rich-rst"-version = "1.3.1"+version = "1.3.2"source = { registry = "https://pypi.org/simple" }dependencies = [{ name = "docutils" },{ name = "rich" },]-sdist = { url = "https://files.pythonhosted.org/packages/b0/69/5514c3a87b5f10f09a34bb011bc0927bc12c596c8dae5915604e71abc386/rich_rst-1.3.1.tar.gz", hash = "sha256:fad46e3ba42785ea8c1785e2ceaa56e0ffa32dbe5410dec432f37e4107c4f383", size = 13839, upload-time = "2024-04-30T04:40:38.125Z" }+sdist = { url = "https://files.pythonhosted.org/packages/bc/6d/a506aaa4a9eaa945ed8ab2b7347859f53593864289853c5d6d62b77246e0/rich_rst-1.3.2.tar.gz", hash = "sha256:a1196fdddf1e364b02ec68a05e8ff8f6914fee10fbca2e6b6735f166bb0da8d4", size = 14936, upload-time = "2025-10-14T16:49:45.332Z" }wheels = [- { url = "https://files.pythonhosted.org/packages/fd/bc/cc4e3dbc5e7992398dcb7a8eda0cbcf4fb792a0cdb93f857b478bf3cf884/rich_rst-1.3.1-py3-none-any.whl", hash = "sha256:498a74e3896507ab04492d326e794c3ef76e7cda078703aa592d1853d91098c1", size = 11621, upload-time = "2024-04-30T04:40:32.619Z" },+ { url = "https://files.pythonhosted.org/packages/13/2f/b4530fbf948867702d0a3f27de4a6aab1d156f406d72852ab902c4d04de9/rich_rst-1.3.2-py3-none-any.whl", hash = "sha256:a99b4907cbe118cf9d18b0b44de272efa61f15117c61e39ebdc431baf5df722a", size = 12567, upload-time = "2025-10-14T16:49:42.953Z" },][[package]]