Tool

Description

load_python_project

Loads a project from local path, Git URL, or archive (.zip/.tar.gz)

unload_python_project

Removes a loaded project from memory

list_loaded_projects

Lists all projects currently in memory

project_metadata

Shows project metadata (build, modules, classes, functions)

detect_build_system

Detects the build system (pip, poetry, pdm, hatch, uv, conda, etc.)

detect_framework

Detects frameworks/libs in use (Flask, Django, FastAPI, SQLAlchemy, etc.)

list_modules

Lists all Python modules in the project

list_classes

Lists all classes in the project

list_functions

Lists all functions and methods in the project

inspect_class

Deep-dives into a class: bases, methods, decorators, docstring

inspect_function

Deep-dives into a function: signature, parameters, body, decorators

list_imports

Lists all imports in the project

list_decorators

Lists all decorators used with their frequencies

find_decorated_elements

Finds classes/functions decorated with a specific decorator

class_hierarchy

Shows inheritance hierarchy (bases and direct subclasses)

search_source

Searches text in the project source code

multi_file_search

Searches text across all loaded projects simultaneously

find_definition

Finds the definition of a symbol (requires type_resolution=True)

find_references

Finds references to a symbol (requires type_resolution=True)

get_file_content

Reads the raw source content of any file in the project

get_source_range

Returns specific source lines with line numbers from a file

validate_code_reference

Checks if a class, function, or variable exists (EXISTS/NOT_FOUND)

resolve_type

Resolves a type name to its definition, tracing imports across the project

inspect_module

Deep-dives into a module: docstring, variables, functions, classes, imports

call_chain

Static call graph: shows which functions are called and which call a given function

variable_xref

Cross-references a variable: shows declarations, writes, and reads across the project

list_enums

Lists all enum classes with their members and values

module_dependency_graph

Builds a dependency map showing which modules import which

list_methods_by_return_type

Finds all functions/methods that return a specific type annotation

find_entry_points

Finds where the program starts: if name, console_scripts, web apps, CLI apps, async runners

list_api_endpoints

Lists all API route/endpoint definitions (FastAPI, Flask, Starlette, Django) with paths and handlers

extract_environment_dependencies

Extracts environment variable reads, config file loads, and Pydantic Field(env=...)

list_side_effects

Classifies functions by side effects: FILE_IO, NETWORK, DB, LOG, MUTATION, or PURE

analyze_error_handling

Analyzes error handling: custom exceptions, raises, try/except patterns, bare excepts

list_public_api

Shows the public API surface: all, init.py re-exports, top-level public definitions

find_test_mapping

Maps production code to tests by analyzing test file imports

extract_domain_vocabulary

Extracts domain-specific vocabulary — key entities, module docstrings, domain terms

Variable

Default

Description

PYMCP_LOG_FILE

/tmp/python_mcp_server.log

Log file path

PYMCP_LOG_LEVEL

INFO

Log level (DEBUG, INFO, WARNING, ERROR)