Schema | MCP Server Framework

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`PYTHONPATH`	Yes	Path to the src directory, required for the server to find the package modules (e.g., /path/to/mcp-server/src).
`MCP_LOG_LEVEL`	No	Logging level (DEBUG, INFO, WARNING, ERROR)	INFO
`MCP_SERVER_NAME`	No	Display name for the server	mcp-server
`MCP_ALLOWED_PATHS`	No	Comma-separated absolute paths for file tools. Required if using file operation tools.

Capabilities

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": false }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`experimental`	{}

Tools

Functions exposed to the LLM to take actions

Name	Description
echo	`Echo back the provided message. Args: message: The message to echo back Returns: The same message, confirming receipt`
echo_uppercase	`Echo back the message in uppercase. Args: message: The message to transform and echo Returns: The message converted to uppercase`
echo_reverse	`Echo back the message reversed. Args: message: The message to reverse Returns: The message with characters in reverse order`
get_current_time	`Get the current date and time in UTC. Args: format: strftime format string (default: %Y-%m-%d %H:%M:%S) Returns: Formatted current date/time string in UTC`
parse_timestamp	`Convert a Unix timestamp to a human-readable format. Args: timestamp: Unix timestamp (seconds since epoch) format: strftime format string Returns: Formatted date/time string in UTC`
get_timestamp	`Get the current Unix timestamp. Returns: Current time as Unix timestamp (seconds since epoch)`
time_difference	`Calculate the difference between two timestamps. Args: start_timestamp: Start Unix timestamp end_timestamp: End Unix timestamp Returns: Human-readable time difference`
list_directory	`List contents of a directory. Requires MCP_ALLOWED_PATHS to be configured with permitted directories. Args: path: Directory path to list Returns: Formatted directory listing or error message`
read_file	`Read contents of a text file. Requires MCP_ALLOWED_PATHS to be configured with permitted directories. Args: path: File path to read max_lines: Maximum number of lines to return (default: 100) Returns: File contents or error message`
get_file_info	`Get information about a file or directory. Requires MCP_ALLOWED_PATHS to be configured with permitted directories. Args: path: Path to get info about Returns: File information or error message`
get_allowed_paths	`Get the list of allowed file system paths. Returns: List of configured allowed paths or instructions to configure`

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

MCP Server Framework

Server Configuration

Capabilities

Tools

Prompts

Resources

Latest Blog Posts

MCP directory API