π The fast, Pythonic way to build MCP servers and clients.
Update docs (#2094)
Jeremiah Lowinc17f96d4e2fb
diff --git a/.github/workflows/run-tests.yml b/.github/workflows/run-tests.ymlindex 80c39dfd1..892f8629d 100644--- a/.github/workflows/run-tests.yml+++ b/.github/workflows/run-tests.yml@@ -1,4 +1,4 @@-name: Run tests+name: Testsenv:# enable colored outputdiff --git a/README.md b/README.mdindex e96b243e4..59f68e37d 100644--- a/README.md+++ b/README.md@@ -15,6 +15,7 @@*Made with βοΈ by [Prefect](https://www.prefect.io/)*[](https://gofastmcp.com)+[](https://discord.gg/uu8dJCgttd)[](https://pypi.org/project/fastmcp)[](https://github.com/jlowin/fastmcp/actions/workflows/run-tests.yml)[](https://github.com/jlowin/fastmcp/blob/main/LICENSE)@@ -70,6 +71,8 @@ There are two ways to access the LLM-friendly documentation:- [`llms.txt`](https://gofastmcp.com/llms.txt) is essentially a sitemap, listing all the pages in the documentation.- [`llms-full.txt`](https://gofastmcp.com/llms-full.txt) contains the entire documentation. Note this may exceed the context window of your LLM.+**Community:** Join our [Discord server](https://discord.gg/uu8dJCgttd) to connect with other FastMCP developers and share what you're building.+---<!-- omit in toc -->diff --git a/docs/community/showcase.mdx b/docs/community/showcase.mdxindex c0a9e3545..fe8ec810d 100644--- a/docs/community/showcase.mdx+++ b/docs/community/showcase.mdx@@ -6,6 +6,12 @@ icon: 'users'import { YouTubeEmbed } from '/snippets/youtube-embed.mdx'+## Join the Community++<Card title="FastMCP Discord" icon="discord" href="https://discord.gg/uu8dJCgttd">+ Connect with other FastMCP developers, share your projects, and discuss ideas.+</Card>+## Featured ProjectsDiscover exemplary MCP servers and implementations created by our community. These projects demonstrate best practices and innovative uses of FastMCP.diff --git a/docs/docs.json b/docs/docs.jsonindex 758eca70f..334804ca5 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -9,10 +9,10 @@"dark": "#222831","light": "#EEEEEE"},- "decoration": "windows"+ "decoration": "gradient"},"banner": {- "content": "Host your server on [FastMCP Cloud](https://fastmcp.cloud) for free!"+ "content": "Join the [FastMCP community](https://discord.gg/uu8dJCgttd)!"},"colors": {"dark": "#f72585",@@ -20,10 +20,7 @@"primary": "#2d00f7"},"contextual": {- "options": [- "copy",- "view"- ]+ "options": ["copy", "view"]},"description": "The fast, Pythonic way to build MCP servers and clients.","favicon": {@@ -32,9 +29,10 @@},"footer": {"socials": {- "bluesky": "https://bsky.app/profile/jlowin.dev",+ "discord": "https://discord.gg/uu8dJCgttd","github": "https://github.com/jlowin/fastmcp",- "x": "https://x.com/jlowin"+ "website": "https://prefect.ai",+ "x": "https://x.com/fastmcp"}},"integrations": {@@ -56,6 +54,11 @@"href": "https://fastmcp.cloud","icon": "cloud","label": "FastMCP Cloud"+ },+ {+ "href": "https://discord.gg/uu8dJCgttd",+ "icon": "discord",+ "label": "Discord"}],"primary": {@@ -64,7 +67,7 @@}},"navigation": {- "tabs": [+ "dropdowns": [{"groups": [{@@ -72,7 +75,8 @@"pages": ["getting-started/welcome","getting-started/installation",- "getting-started/quickstart"+ "getting-started/quickstart",+ "updates"]},{@@ -132,10 +136,7 @@{"group": "Essentials","icon": "cube",- "pages": [- "clients/client",- "clients/transports"- ]+ "pages": ["clients/client", "clients/transports"]},{"group": "Core Operations",@@ -161,10 +162,7 @@{"group": "Authentication","icon": "user-shield",- "pages": [- "clients/auth/oauth",- "clients/auth/bearer"- ]+ "pages": ["clients/auth/oauth", "clients/auth/bearer"]}]},@@ -240,18 +238,13 @@"pages": ["development/contributing","development/tests",- "development/releases"+ "development/releases",+ "changelog"]}],- "tab": "Documentation"- },- {- "pages": [- "updates",- "changelog"- ],- "tab": "What's New"+ "dropdown": "Documentation",+ "icon": "book"},{"anchors": [@@ -437,7 +430,8 @@]}],- "tab": "SDK Reference"+ "dropdown": "SDK Reference",+ "icon": "code"}]},@@ -454,7 +448,14 @@"search": {"prompt": "Search the docs..."},- "theme": "mint",+ "theme": "almond",+ "errors": {+ "404": {+ "redirect": false,+ "title": "Don't panic.",+ "description": "Youβve wandered outside the context."+ }+ },"thumbnails": {"appearance": "light","background": "/assets/brand/thumbnail-background.png"diff --git a/docs/getting-started/welcome.mdx b/docs/getting-started/welcome.mdxindex bc03f0fb1..738f5d3ca 100644--- a/docs/getting-started/welcome.mdx+++ b/docs/getting-started/welcome.mdx@@ -3,6 +3,7 @@ title: "Welcome to FastMCP 2.0!"sidebarTitle: "Welcome!"description: The fast, Pythonic way to build MCP servers and clients.icon: hand-wave+mode: wide---<imgsrc="/assets/brand/f-watercolor-waves.png"@@ -38,12 +39,13 @@ if __name__ == "__main__":## Beyond Basic MCP-FastMCP pioneered Python MCP development, with FastMCP 1.0 being incorporated into the [official MCP SDK](https://github.com/modelcontextprotocol/python-sdk) in 2024.+FastMCP pioneered Python MCP development, and FastMCP 1.0 was incorporated into the [official MCP SDK](https://github.com/modelcontextprotocol/python-sdk) in 2024.-**This is FastMCP 2.0** β the actively maintained version that extends far beyond basic protocol implementation. While the SDK provides core functionality, FastMCP 2.0 delivers everything needed for production: advanced MCP patterns (server composition, proxying, OpenAPI/FastAPI generation, tool transformation), enterprise auth (Google, GitHub, Azure, Auth0, WorkOS, and more), deployment tools, testing frameworks, and comprehensive client libraries.+**This is FastMCP 2.0,** the actively maintained version that extends far beyond basic protocol implementation. While the SDK provides core functionality, FastMCP 2.0 delivers everything needed for production: advanced MCP patterns (server composition, proxying, OpenAPI/FastAPI generation, tool transformation), enterprise auth (Google, GitHub, Azure, Auth0, WorkOS, and more), deployment tools, testing frameworks, and comprehensive client libraries.Ready to build? Start with our [installation guide](/getting-started/installation) or jump straight to the [quickstart](/getting-started/quickstart).+FastMCP is made with π by [Prefect](https://www.prefect.io/).## What is MCP?@@ -70,7 +72,6 @@ FastMCP handles all the complex protocol details so you can focus on building. IFastMCP provides the shortest path from idea to production. Deploy locally, to the cloud with [FastMCP Cloud](https://fastmcp.cloud) (free for personal servers), or to your own infrastructure.-FastMCP is made with π by [Prefect](https://www.prefect.io/).@@ -99,7 +100,7 @@ async def main():asyncio.run(main())```-### Plain Text Formats+### Text FormatsThe docs are also available in [llms.txt format](https://llmstxt.org/):- [llms.txt](https://gofastmcp.com/llms.txt) - A sitemap listing all documentation pages