Skip to content

Commit dcfd9ee

Browse files
authored
Pin Cyclopts to v4.0.0 + compliance note (#2354)
* Pin cyclopts to v5.0.0a1+ * Document cyclopts/docutils licensing * Update docs
1 parent 8ad2dfc commit dcfd9ee

File tree

4 files changed

+29
-12
lines changed

4 files changed

+29
-12
lines changed

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -143,6 +143,8 @@ uv pip install fastmcp
143143

144144
For full installation instructions, including verification, upgrading from the official MCPSDK, and developer setup, see the [**Installation Guide**](https://gofastmcp.com/getting-started/installation).
145145

146+
**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.
147+
146148
## Core Concepts
147149

148150
These are the building blocks for creating MCP servers and clients with FastMCP.

docs/getting-started/installation.mdx

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,20 @@ Python version: 3.12.2
4242
Platform: macOS-15.3.1-arm64-arm-64bit
4343
FastMCP root path: ~/Developer/fastmcp
4444
```
45+
46+
### Dependency Licensing
47+
48+
<Info>
49+
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.
50+
51+
If this is a concern, you can install Cyclopts v5 alpha which removes this dependency:
52+
53+
```bash
54+
pip install "cyclopts>=5.0.0a1"
55+
```
56+
57+
Alternatively, wait for the stable v5 release. See [this issue](https://github.com/BrianPugh/cyclopts/issues/672) for details.
58+
</Info>
4559
## Upgrading from the Official MCP SDK
4660

4761
Upgrading 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.

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ dependencies = [
1111
"openapi-pydantic>=0.5.1",
1212
"platformdirs>=4.0.0",
1313
"rich>=13.9.4",
14-
"cyclopts>=3.0.0",
14+
"cyclopts>=4.0.0",
1515
"authlib>=1.6.5",
1616
"pydantic[email]>=2.11.7",
1717
"pyperclip>=1.9.0",

uv.lock

Lines changed: 12 additions & 11 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)