mirror of
https://github.com/PrefectHQ/fastmcp.git
synced 2026-08-10 07:39:10 +02:00
80 lines
2.4 KiB
Text
80 lines
2.4 KiB
Text
---
|
|
title: cli
|
|
sidebarTitle: cli
|
|
---
|
|
|
|
# `fastmcp.cli.cli`
|
|
|
|
|
|
FastMCP CLI tools using Cyclopts.
|
|
|
|
## Functions
|
|
|
|
### `version` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/cli.py#L103" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
version()
|
|
```
|
|
|
|
|
|
Display version information and platform details.
|
|
|
|
|
|
### `dev` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/cli.py#L141" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
dev(server_spec: str) -> None
|
|
```
|
|
|
|
|
|
Run an MCP server with the MCP Inspector for development.
|
|
|
|
**Args:**
|
|
- `server_spec`: Python file to run, optionally with \:object suffix
|
|
|
|
|
|
### `run` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/cli.py#L286" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
run(server_spec: str, *server_args: str) -> None
|
|
```
|
|
|
|
|
|
Run an MCP server or connect to a remote one.
|
|
|
|
The server can be specified in four ways:
|
|
1. Module approach: "server.py" - runs the module directly, looking for an object named 'mcp', 'server', or 'app'
|
|
2. Import approach: "server.py:app" - imports and runs the specified server object
|
|
3. URL approach: "http://server-url" - connects to a remote server and creates a proxy
|
|
4. MCPConfig file: "mcp.json" - runs as a proxy server for the MCP Servers in the MCPConfig file
|
|
|
|
Server arguments can be passed after -- :
|
|
fastmcp run server.py -- --config config.json --debug
|
|
|
|
**Args:**
|
|
- `server_spec`: Python file, object specification (file\:obj), MCPConfig file, or URL
|
|
|
|
|
|
### `inspect` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/cli/cli.py#L439" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
inspect(server_spec: str) -> None
|
|
```
|
|
|
|
|
|
Inspect an MCP server and generate a JSON report.
|
|
|
|
This command analyzes an MCP server and generates a comprehensive JSON report
|
|
containing information about the server's name, instructions, version, tools,
|
|
prompts, resources, templates, and capabilities.
|
|
|
|
**Examples:**
|
|
|
|
fastmcp inspect server.py
|
|
fastmcp inspect server.py -o report.json
|
|
fastmcp inspect server.py:mcp -o analysis.json
|
|
fastmcp inspect path/to/server.py:app -o /tmp/server-info.json
|
|
|
|
**Args:**
|
|
- `server_spec`: Python file to inspect, optionally with \:object suffix
|
|
|