π The fast, Pythonic way to build MCP servers and clients.
Update schema path (#1595)
Jeremiah Lowinb34519c35614
diff --git a/docs/deployment/server-configuration.mdx b/docs/deployment/server-configuration.mdxindex bee3eb72f..f132e9c6b 100644--- a/docs/deployment/server-configuration.mdx+++ b/docs/deployment/server-configuration.mdx@@ -33,7 +33,7 @@ FastMCP provides JSON schemas for IDE autocomplete and validation. Add the schem```json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "server.py","object": "mcp"@@ -42,8 +42,8 @@ FastMCP provides JSON schemas for IDE autocomplete and validation. Add the schem```Two schema URLs are available:-- **Version-specific**: `https://gofastmcp.com/schemas/fastmcp_config/v1.json`-- **Latest version**: `https://gofastmcp.com/schemas/fastmcp_config/latest.json`+- **Version-specific**: `https://gofastmcp.com/public/schemas/fastmcp.json/v1.json`+- **Latest version**: `https://gofastmcp.com/public/schemas/fastmcp.json/latest.json`Modern IDEs like VS Code will automatically provide autocomplete suggestions, validation, and inline documentation when the schema is specified.@@ -53,7 +53,7 @@ The `fastmcp.json` file has three main sections, each controlling a different as```json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "server.py","object": "mcp"@@ -261,7 +261,7 @@ A minimal configuration for a simple server:```json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "server.py","object": "mcp"@@ -276,7 +276,7 @@ A configuration optimized for local development:```json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": "src/server.py:app","environment": {"python": "3.12",@@ -302,7 +302,7 @@ A production-ready configuration with full dependency management:```json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "app/main.py","object": "mcp_server"@@ -335,7 +335,7 @@ Configuration for a data analysis server with scientific packages:```json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "analysis_server.py","object": "mcp"@@ -367,7 +367,7 @@ You can maintain multiple configuration files for different environments:**dev.fastmcp.json**:```json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "server.py","object": "mcp"@@ -382,7 +382,7 @@ You can maintain multiple configuration files for different environments:**prod.fastmcp.json**:```json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "server.py","object": "mcp"@@ -515,7 +515,7 @@ uv run --with pandas --with requests \**Equivalent fastmcp.json**:```json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "server.py","object": "mcp"diff --git a/docs/integrations/claude-code.mdx b/docs/integrations/claude-code.mdxindex 62e0ef29a..2a66c8f22 100644--- a/docs/integrations/claude-code.mdx+++ b/docs/integrations/claude-code.mdx@@ -85,7 +85,7 @@ Alternatively, you can use a `fastmcp.json` configuration file (recommended):```json fastmcp.json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "server.py","object": "mcp"diff --git a/docs/integrations/claude-desktop.mdx b/docs/integrations/claude-desktop.mdxindex 20c42d93d..baa7bc47e 100644--- a/docs/integrations/claude-desktop.mdx+++ b/docs/integrations/claude-desktop.mdx@@ -102,7 +102,7 @@ Alternatively, you can use a `fastmcp.json` configuration file (recommended):```json fastmcp.json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "server.py","object": "mcp"diff --git a/docs/integrations/cursor.mdx b/docs/integrations/cursor.mdxindex b648aee48..329047011 100644--- a/docs/integrations/cursor.mdx+++ b/docs/integrations/cursor.mdx@@ -103,7 +103,7 @@ Alternatively, you can use a `fastmcp.json` configuration file (recommended):```json fastmcp.json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "server.py","object": "mcp"diff --git a/docs/integrations/mcp-json-configuration.mdx b/docs/integrations/mcp-json-configuration.mdxindex 654d6b041..394687d0a 100644--- a/docs/integrations/mcp-json-configuration.mdx+++ b/docs/integrations/mcp-json-configuration.mdx@@ -178,7 +178,7 @@ You can also use a `fastmcp.json` configuration file (recommended):```json fastmcp.json{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "server.py","object": "mcp"diff --git a/docs/public/schemas/fastmcp-json/latest.json b/docs/public/schemas/fastmcp-json/latest.jsonnew file mode 100644index 000000000..db5b8650e--- /dev/null+++ b/docs/public/schemas/fastmcp-json/latest.json@@ -0,0 +1,296 @@+{+ "$defs": {+ "DeploymentConfig": {+ "description": "Configuration for server deployment and runtime settings.",+ "properties": {+ "transport": {+ "anyOf": [+ {+ "enum": ["stdio", "http", "sse"],+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Transport protocol to use",+ "title": "Transport"+ },+ "host": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Host to bind to when using HTTP transport",+ "examples": ["127.0.0.1", "0.0.0.0", "localhost"],+ "title": "Host"+ },+ "port": {+ "anyOf": [+ {+ "type": "integer"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Port to bind to when using HTTP transport",+ "examples": [8000, 3000, 5000],+ "title": "Port"+ },+ "path": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "URL path for the server endpoint",+ "examples": ["/mcp/", "/api/mcp/", "/sse/"],+ "title": "Path"+ },+ "log_level": {+ "anyOf": [+ {+ "enum": ["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"],+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Log level for the server",+ "title": "Log Level"+ },+ "cwd": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Working directory for the server process",+ "examples": [".", "./src", "/app"],+ "title": "Cwd"+ },+ "env": {+ "anyOf": [+ {+ "additionalProperties": {+ "type": "string"+ },+ "type": "object"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Environment variables to set when running the server",+ "examples": [+ {+ "API_KEY": "secret",+ "DEBUG": "true"+ }+ ],+ "title": "Env"+ },+ "args": {+ "anyOf": [+ {+ "items": {+ "type": "string"+ },+ "type": "array"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Arguments to pass to the server (after --)",+ "examples": [["--config", "config.json", "--debug"]],+ "title": "Args"+ }+ },+ "title": "DeploymentConfig",+ "type": "object"+ },+ "EntrypointConfig": {+ "description": "Configuration for server entrypoint when using object format.",+ "properties": {+ "file": {+ "description": "Path to Python file containing the server",+ "examples": ["server.py", "src/server.py", "app/main.py"],+ "title": "File",+ "type": "string"+ },+ "object": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Name of the server object in the file (defaults to searching for mcp/server/app)",+ "examples": ["app", "mcp", "server"],+ "title": "Object"+ },+ "repo": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Git repository URL",+ "examples": ["https://github.com/user/repo"],+ "title": "Repo"+ }+ },+ "required": ["file"],+ "title": "EntrypointConfig",+ "type": "object"+ },+ "EnvironmentConfig": {+ "description": "Configuration for Python environment setup.",+ "properties": {+ "python": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Python version constraint",+ "examples": ["3.10", "3.11", "3.12"],+ "title": "Python"+ },+ "dependencies": {+ "anyOf": [+ {+ "items": {+ "type": "string"+ },+ "type": "array"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Python packages to install with PEP 508 specifiers",+ "examples": [["fastmcp>=2.0,<3", "httpx", "pandas>=2.0"]],+ "title": "Dependencies"+ },+ "requirements": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Path to requirements.txt file",+ "examples": ["requirements.txt", "../requirements/prod.txt"],+ "title": "Requirements"+ },+ "project": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Path to project directory containing pyproject.toml",+ "examples": [".", "../my-project"],+ "title": "Project"+ },+ "editable": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Directory to install in editable mode",+ "examples": [".", "../my-package"],+ "title": "Editable"+ }+ },+ "title": "EnvironmentConfig",+ "type": "object"+ }+ },+ "description": "Configuration file for FastMCP servers",+ "properties": {+ "$schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json",+ "description": "JSON schema for IDE support and validation",+ "title": "$Schema"+ },+ "entrypoint": {+ "$ref": "#/$defs/EntrypointConfig",+ "description": "Server entrypoint as a string (file or file:object) or object with file/object/repo",+ "examples": [+ "server.py",+ "server.py:app",+ {+ "file": "src/server.py",+ "object": "app"+ }+ ]+ },+ "environment": {+ "$ref": "#/$defs/EnvironmentConfig",+ "description": "Python environment setup configuration"+ },+ "deployment": {+ "$ref": "#/$defs/DeploymentConfig",+ "description": "Server deployment and runtime settings"+ }+ },+ "required": ["entrypoint"],+ "title": "FastMCP Configuration",+ "type": "object",+ "$id": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json"+}diff --git a/docs/public/schemas/fastmcp-json/v1.json b/docs/public/schemas/fastmcp-json/v1.jsonnew file mode 100644index 000000000..db5b8650e--- /dev/null+++ b/docs/public/schemas/fastmcp-json/v1.json@@ -0,0 +1,296 @@+{+ "$defs": {+ "DeploymentConfig": {+ "description": "Configuration for server deployment and runtime settings.",+ "properties": {+ "transport": {+ "anyOf": [+ {+ "enum": ["stdio", "http", "sse"],+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Transport protocol to use",+ "title": "Transport"+ },+ "host": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Host to bind to when using HTTP transport",+ "examples": ["127.0.0.1", "0.0.0.0", "localhost"],+ "title": "Host"+ },+ "port": {+ "anyOf": [+ {+ "type": "integer"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Port to bind to when using HTTP transport",+ "examples": [8000, 3000, 5000],+ "title": "Port"+ },+ "path": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "URL path for the server endpoint",+ "examples": ["/mcp/", "/api/mcp/", "/sse/"],+ "title": "Path"+ },+ "log_level": {+ "anyOf": [+ {+ "enum": ["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"],+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Log level for the server",+ "title": "Log Level"+ },+ "cwd": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Working directory for the server process",+ "examples": [".", "./src", "/app"],+ "title": "Cwd"+ },+ "env": {+ "anyOf": [+ {+ "additionalProperties": {+ "type": "string"+ },+ "type": "object"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Environment variables to set when running the server",+ "examples": [+ {+ "API_KEY": "secret",+ "DEBUG": "true"+ }+ ],+ "title": "Env"+ },+ "args": {+ "anyOf": [+ {+ "items": {+ "type": "string"+ },+ "type": "array"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Arguments to pass to the server (after --)",+ "examples": [["--config", "config.json", "--debug"]],+ "title": "Args"+ }+ },+ "title": "DeploymentConfig",+ "type": "object"+ },+ "EntrypointConfig": {+ "description": "Configuration for server entrypoint when using object format.",+ "properties": {+ "file": {+ "description": "Path to Python file containing the server",+ "examples": ["server.py", "src/server.py", "app/main.py"],+ "title": "File",+ "type": "string"+ },+ "object": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Name of the server object in the file (defaults to searching for mcp/server/app)",+ "examples": ["app", "mcp", "server"],+ "title": "Object"+ },+ "repo": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Git repository URL",+ "examples": ["https://github.com/user/repo"],+ "title": "Repo"+ }+ },+ "required": ["file"],+ "title": "EntrypointConfig",+ "type": "object"+ },+ "EnvironmentConfig": {+ "description": "Configuration for Python environment setup.",+ "properties": {+ "python": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Python version constraint",+ "examples": ["3.10", "3.11", "3.12"],+ "title": "Python"+ },+ "dependencies": {+ "anyOf": [+ {+ "items": {+ "type": "string"+ },+ "type": "array"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Python packages to install with PEP 508 specifiers",+ "examples": [["fastmcp>=2.0,<3", "httpx", "pandas>=2.0"]],+ "title": "Dependencies"+ },+ "requirements": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Path to requirements.txt file",+ "examples": ["requirements.txt", "../requirements/prod.txt"],+ "title": "Requirements"+ },+ "project": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Path to project directory containing pyproject.toml",+ "examples": [".", "../my-project"],+ "title": "Project"+ },+ "editable": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Directory to install in editable mode",+ "examples": [".", "../my-package"],+ "title": "Editable"+ }+ },+ "title": "EnvironmentConfig",+ "type": "object"+ }+ },+ "description": "Configuration file for FastMCP servers",+ "properties": {+ "$schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json",+ "description": "JSON schema for IDE support and validation",+ "title": "$Schema"+ },+ "entrypoint": {+ "$ref": "#/$defs/EntrypointConfig",+ "description": "Server entrypoint as a string (file or file:object) or object with file/object/repo",+ "examples": [+ "server.py",+ "server.py:app",+ {+ "file": "src/server.py",+ "object": "app"+ }+ ]+ },+ "environment": {+ "$ref": "#/$defs/EnvironmentConfig",+ "description": "Python environment setup configuration"+ },+ "deployment": {+ "$ref": "#/$defs/DeploymentConfig",+ "description": "Server deployment and runtime settings"+ }+ },+ "required": ["entrypoint"],+ "title": "FastMCP Configuration",+ "type": "object",+ "$id": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json"+}diff --git a/examples/atproto_mcp/fastmcp.json b/examples/atproto_mcp/fastmcp.jsonindex 96b93bd1f..0cab8397d 100644--- a/examples/atproto_mcp/fastmcp.json+++ b/examples/atproto_mcp/fastmcp.json@@ -1,9 +1,9 @@{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": "src/atproto_mcp/server.py","environment": {"dependencies": ["atproto_mcp@git+https://github.com/jlowin/fastmcp.git#subdirectory=examples/atproto_mcp"]}-}\ No newline at end of file+}diff --git a/examples/fastmcp_config/env_interpolation_example.json b/examples/fastmcp_config/env_interpolation_example.jsonindex 9b49c831b..0eb4af048 100644--- a/examples/fastmcp_config/env_interpolation_example.json+++ b/examples/fastmcp_config/env_interpolation_example.json@@ -1,5 +1,5 @@{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": "src/server.py:app","environment": {"python": "3.12",@@ -17,4 +17,4 @@"FEATURE_FLAGS": "${FEATURE_FLAGS}"}}-}\ No newline at end of file+}diff --git a/examples/fastmcp_config/full_example.fastmcp.json b/examples/fastmcp_config/full_example.fastmcp.jsonindex 9212903b7..98126fcf5 100644--- a/examples/fastmcp_config/full_example.fastmcp.json+++ b/examples/fastmcp_config/full_example.fastmcp.json@@ -1,15 +1,12 @@{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "server.py","object": "mcp"},"environment": {"python": "3.12",- "dependencies": [- "requests>=2.31.0",- "httpx"- ],+ "dependencies": ["requests>=2.31.0", "httpx"],"requirements": null,"project": null,"editable": null@@ -27,4 +24,4 @@"cwd": null,"args": null}-}\ No newline at end of file+}diff --git a/examples/fastmcp_config_demo/fastmcp.json b/examples/fastmcp_config_demo/fastmcp.jsonindex 022216c43..79b51973e 100644--- a/examples/fastmcp_config_demo/fastmcp.json+++ b/examples/fastmcp_config_demo/fastmcp.json@@ -1,15 +1,12 @@{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": "server.py","environment": {"python": "3.11",- "dependencies": [- "pyautogui",- "Pillow"- ]+ "dependencies": ["pyautogui", "Pillow"]},"deployment": {"transport": "stdio","log_level": "INFO"}-}\ No newline at end of file+}diff --git a/examples/memory.fastmcp.json b/examples/memory.fastmcp.jsonindex d92f97872..5ee1aea97 100644--- a/examples/memory.fastmcp.json+++ b/examples/memory.fastmcp.json@@ -1,12 +1,7 @@{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": "memory.py","environment": {- "dependencies": [- "pydantic-ai-slim[openai]",- "asyncpg",- "numpy",- "pgvector"- ]+ "dependencies": ["pydantic-ai-slim[openai]", "asyncpg", "numpy", "pgvector"]}-}\ No newline at end of file+}diff --git a/examples/mount_example.fastmcp.json b/examples/mount_example.fastmcp.jsonindex 7ad9e3c00..d30d2e3e9 100644--- a/examples/mount_example.fastmcp.json+++ b/examples/mount_example.fastmcp.json@@ -1,4 +1,4 @@{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": "mount_example.py"-}\ No newline at end of file+}diff --git a/examples/screenshot.fastmcp.json b/examples/screenshot.fastmcp.jsonindex ef35e6fdd..9ff06d797 100644--- a/examples/screenshot.fastmcp.json+++ b/examples/screenshot.fastmcp.json@@ -1,7 +1,7 @@{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": "screenshot.py","environment": {"dependencies": ["pyautogui", "Pillow"]}-}\ No newline at end of file+}diff --git a/examples/smart_home/hub.fastmcp.json b/examples/smart_home/hub.fastmcp.jsonindex 175c8961c..3e84fc8c6 100644--- a/examples/smart_home/hub.fastmcp.json+++ b/examples/smart_home/hub.fastmcp.json@@ -1,9 +1,9 @@{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": "src/smart_home/hub.py","environment": {"dependencies": ["smart_home@git+https://github.com/jlowin/fastmcp.git#subdirectory=examples/smart_home"]}-}\ No newline at end of file+}diff --git a/examples/smart_home/lights.fastmcp.json b/examples/smart_home/lights.fastmcp.jsonindex 27bba2a06..23b0b3176 100644--- a/examples/smart_home/lights.fastmcp.json+++ b/examples/smart_home/lights.fastmcp.json@@ -1,9 +1,9 @@{- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": "src/smart_home/lights/server.py","environment": {"dependencies": ["smart_home@git+https://github.com/jlowin/fastmcp.git#subdirectory=examples/smart_home"]}-}\ No newline at end of file+}diff --git a/src/fastmcp/utilities/fastmcp_config/v1/fastmcp_config.py b/src/fastmcp/utilities/fastmcp_config/v1/fastmcp_config.pyindex aeb1dac38..458895a6b 100644--- a/src/fastmcp/utilities/fastmcp_config/v1/fastmcp_config.py+++ b/src/fastmcp/utilities/fastmcp_config/v1/fastmcp_config.py@@ -20,7 +20,7 @@ from fastmcp.utilities.logging import get_loggerlogger = get_logger("cli.config")# JSON Schema for IDE support-FASTMCP_JSON_SCHEMA = "https://gofastmcp.com/schemas/fastmcp_config/v1.json"+FASTMCP_JSON_SCHEMA = "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json"class EntrypointConfig(BaseModel):@@ -324,7 +324,7 @@ class FastMCPConfig(BaseModel):# Schema field for IDE supportschema_: str | None = Field(- default="https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ default="https://gofastmcp.com/public/schemas/fastmcp.json/v1.json",alias="$schema",description="JSON schema for IDE support and validation",)diff --git a/src/fastmcp/utilities/fastmcp_config/v1/schema.json b/src/fastmcp/utilities/fastmcp_config/v1/schema.jsonindex a7c98df6e..db5b8650e 100644--- a/src/fastmcp/utilities/fastmcp_config/v1/schema.json+++ b/src/fastmcp/utilities/fastmcp_config/v1/schema.json@@ -6,11 +6,7 @@"transport": {"anyOf": [{- "enum": [- "stdio",- "http",- "sse"- ],+ "enum": ["stdio", "http", "sse"],"type": "string"},{@@ -32,11 +28,7 @@],"default": null,"description": "Host to bind to when using HTTP transport",- "examples": [- "127.0.0.1",- "0.0.0.0",- "localhost"- ],+ "examples": ["127.0.0.1", "0.0.0.0", "localhost"],"title": "Host"},"port": {@@ -50,11 +42,7 @@],"default": null,"description": "Port to bind to when using HTTP transport",- "examples": [- 8000,- 3000,- 5000- ],+ "examples": [8000, 3000, 5000],"title": "Port"},"path": {@@ -68,23 +56,13 @@],"default": null,"description": "URL path for the server endpoint",- "examples": [- "/mcp/",- "/api/mcp/",- "/sse/"- ],+ "examples": ["/mcp/", "/api/mcp/", "/sse/"],"title": "Path"},"log_level": {"anyOf": [{- "enum": [- "DEBUG",- "INFO",- "WARNING",- "ERROR",- "CRITICAL"- ],+ "enum": ["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"],"type": "string"},{@@ -106,11 +84,7 @@],"default": null,"description": "Working directory for the server process",- "examples": [- ".",- "./src",- "/app"- ],+ "examples": [".", "./src", "/app"],"title": "Cwd"},"env": {@@ -149,13 +123,7 @@],"default": null,"description": "Arguments to pass to the server (after --)",- "examples": [- [- "--config",- "config.json",- "--debug"- ]- ],+ "examples": [["--config", "config.json", "--debug"]],"title": "Args"}},@@ -167,11 +135,7 @@"properties": {"file": {"description": "Path to Python file containing the server",- "examples": [- "server.py",- "src/server.py",- "app/main.py"- ],+ "examples": ["server.py", "src/server.py", "app/main.py"],"title": "File","type": "string"},@@ -186,11 +150,7 @@],"default": null,"description": "Name of the server object in the file (defaults to searching for mcp/server/app)",- "examples": [- "app",- "mcp",- "server"- ],+ "examples": ["app", "mcp", "server"],"title": "Object"},"repo": {@@ -204,15 +164,11 @@],"default": null,"description": "Git repository URL",- "examples": [- "https://github.com/user/repo"- ],+ "examples": ["https://github.com/user/repo"],"title": "Repo"}},- "required": [- "file"- ],+ "required": ["file"],"title": "EntrypointConfig","type": "object"},@@ -230,11 +186,7 @@],"default": null,"description": "Python version constraint",- "examples": [- "3.10",- "3.11",- "3.12"- ],+ "examples": ["3.10", "3.11", "3.12"],"title": "Python"},"dependencies": {@@ -251,13 +203,7 @@],"default": null,"description": "Python packages to install with PEP 508 specifiers",- "examples": [- [- "fastmcp>=2.0,<3",- "httpx",- "pandas>=2.0"- ]- ],+ "examples": [["fastmcp>=2.0,<3", "httpx", "pandas>=2.0"]],"title": "Dependencies"},"requirements": {@@ -271,10 +217,7 @@],"default": null,"description": "Path to requirements.txt file",- "examples": [- "requirements.txt",- "../requirements/prod.txt"- ],+ "examples": ["requirements.txt", "../requirements/prod.txt"],"title": "Requirements"},"project": {@@ -288,10 +231,7 @@],"default": null,"description": "Path to project directory containing pyproject.toml",- "examples": [- ".",- "../my-project"- ],+ "examples": [".", "../my-project"],"title": "Project"},"editable": {@@ -305,10 +245,7 @@],"default": null,"description": "Directory to install in editable mode",- "examples": [- ".",- "../my-package"- ],+ "examples": [".", "../my-package"],"title": "Editable"}},@@ -327,7 +264,7 @@"type": "null"}],- "default": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "default": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","description": "JSON schema for IDE support and validation","title": "$Schema"},@@ -352,10 +289,8 @@"description": "Server deployment and runtime settings"}},- "required": [- "entrypoint"- ],+ "required": ["entrypoint"],"title": "FastMCP Configuration","type": "object",- "$id": "https://gofastmcp.com/schemas/fastmcp_config/v1.json"-}\ No newline at end of file+ "$id": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json"+}diff --git a/tests/cli/test_config.py b/tests/cli/test_config.pyindex 707bc226a..d8ad92b73 100644--- a/tests/cli/test_config.py+++ b/tests/cli/test_config.py@@ -365,7 +365,7 @@ class TestFastMCPConfig:def test_from_file(self, tmp_path):"""Test loading config from JSON file with nested structure."""config_data = {- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": {"file": "src/server.py", "object": "app"},"environment": {"python": "3.12", "dependencies": ["requests"]},"deployment": {"transport": "http", "port": 8000},diff --git a/tests/cli/test_fastmcp_config_integration.py b/tests/cli/test_fastmcp_config_integration.pyindex 01b305d89..758661ab2 100644--- a/tests/cli/test_fastmcp_config_integration.py+++ b/tests/cli/test_fastmcp_config_integration.py@@ -37,7 +37,7 @@ if __name__ == "__main__":# Create config fileconfig_data = {- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": "server.py","environment": {"python": sys.version.split()[0], # Use current Python versiondiff --git a/tests/cli/test_fastmcp_config_schema.py b/tests/cli/test_fastmcp_config_schema.pyindex f2ac44672..133a52eaa 100644--- a/tests/cli/test_fastmcp_config_schema.py+++ b/tests/cli/test_fastmcp_config_schema.py@@ -43,7 +43,7 @@ def test_schema_has_correct_id():assert "$id" in generated_schemaassert (generated_schema["$id"]- == "https://gofastmcp.com/schemas/fastmcp_config/v1.json"+ == "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json")diff --git a/tests/cli/test_run_config.py b/tests/cli/test_run_config.pyindex f0e444c8a..50bed5136 100644--- a/tests/cli/test_run_config.py+++ b/tests/cli/test_run_config.py@@ -18,7 +18,7 @@ from fastmcp.utilities.fastmcp_config import (def sample_config(tmp_path):"""Create a sample fastmcp.json configuration file with nested structure."""config_data = {- "$schema": "https://gofastmcp.com/schemas/fastmcp_config/v1.json",+ "$schema": "https://gofastmcp.com/public/schemas/fastmcp.json/v1.json","entrypoint": "server.py","environment": {"python": "3.11", "dependencies": ["requests"]},"deployment": {"transport": "stdio", "env": {"TEST_VAR": "test_value"}},