Serveur MCP Code Pathfinder
✓ VérifiéPermettez à vos assistants IA d'interroger des graphes d'appels, de tracer les flux de données et d'exécuter des règles de sécurité sur des projets Python.
Aussi connu sous shivasurya/code-pathfinder, code-pathfinder, codepathfinder
- Étoiles
- 143
- Outils
- —
- Téléchargements, 30 jours
- 426
- Dernière version
- 2.1.1
- Dernier commit
- 10 juil. 2026
- Licence
- Apache-2.0
Qu'est-ce que Code Pathfinder MCP ?
Code Pathfinder est un serveur MCP. Permettez à vos assistants IA d'interroger des graphes d'appels, de tracer les flux de données et d'exécuter des règles de sécurité sur des projets Python.
Résumé généré à partir du README du projet
À propos du MCP server Code Pathfinder
Les ingénieurs sécurité et les développeurs peuvent utiliser Code Pathfinder pour effectuer une analyse statique approfondie sur des projets Python, des Dockerfiles et des fichiers Docker Compose. En intégrant ce MCP server dans des assistants de codage IA comme Claude Code, Cursor ou Cline, les utilisateurs peuvent doter leur IA d'une compréhension sophistiquée de la structure du code et des vulnérabilités de sécurité. Le serveur permet à une IA d'interroger des graphes d'appels, de tracer la circulation des données dans un système et d'exécuter des règles de sécurité spécifiques directement dans le flux de développement.
A diferencia des outils classiques de recherche par patterns, ce moteur effectue une analyse de flux de données inter-fichiers pour suivre des données corrompues (tainted data) d'une source dans un fichier vers un puits (sink) dans un autre. Il utilise Tree-sitter pour construire des arbres de syntaxe abstraite (AST) et génère un graphe de dépendance de variables pour cartographier les interactions complexes. Le système ne nécessite aucune clé API ni compte cloud, fonctionnant entièrement en local une fois installé via Homebrew ou pip. Il inclut 190 règles prêtes à l'emploi couvrant des problèmes courants comme l'injection SQL et le RCE, qui se téléchargent automatiquement depuis un CDN.
Ce que vous pouvez faire avec
- 1Tracer les flux de données inter-fichiersDemandez à votre assistant IA de suivre une entrée utilisateur depuis un gestionnaire HTTP à travers diverses fonctions pour vérifier si elle atteint une requête de base de données.
- 2Auditer les vulnérabilités de sécurité PythonDemandez à un assistant IA d'exécuter des jeux de règles de sécurité spécifiques pour identifier des vulnérabilités telles que l'injection SQL ou le RCE dans une base de code Python.
- 3Interroger la structure de la base de codeDemandez à l'assistant IA de trouver tous les appelants ou appelés d'une fonction spécifique en utilisant le graphe d'appels généré.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Code Pathfinder MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Code Pathfinder MCP dans Claude Code
$ claude mcp add code-pathfinder -- uvx codepathfinderInstaller Code Pathfinder MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"code-pathfinder": {
"command": "uvx",
"args": [
"codepathfinder"
]
}
}
}Installer Code Pathfinder MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"code-pathfinder": {
"type": "stdio",
"command": "uvx",
"args": [
"codepathfinder"
]
}
}
}Installer Code Pathfinder MCP dans VS Code CLI
$ code --add-mcp '{"name":"code-pathfinder","type":"stdio","command":"uvx","args":["codepathfinder"]}'Installer Code Pathfinder MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"code-pathfinder": {
"command": "uvx",
"args": [
"codepathfinder"
]
}
}
}Installer Code Pathfinder MCP dans Codex
$ codex mcp add code-pathfinder -- uvx codepathfinderInstaller Code Pathfinder MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.code-pathfinder] command = "uvx" args = ["codepathfinder"]
Installer Code Pathfinder MCP dans Gemini CLI
$ gemini mcp add -s user code-pathfinder uvx -- codepathfinderInstaller Code Pathfinder MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"code-pathfinder": {
"command": "uvx",
"args": [
"codepathfinder"
]
}
}
}Vérifications automatisées
Exécuté le 12 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSNon vérifié
- Les outils destructifs sont étiquetésNon vérifié
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur GitHubWebsite · Docs · Rule Registry · MCP Server · Blog
Quick Start
Install:
brew install shivasurya/tap/pathfinder
Scan a Python project (rules download automatically):
pathfinder scan --ruleset python/all --project .
Scan Dockerfiles:
pathfinder scan --ruleset docker/all --project .
No config files, no API keys, no cloud accounts. Results in your terminal in seconds.
What is Code Pathfinder?
Code Pathfinder is an open-source static analysis engine that builds a graph of your codebase and traces how data flows through it. It parses source code into Abstract Syntax Trees, constructs call graphs across files, and runs taint analysis to find source-to-sink vulnerabilities that span multiple files and function boundaries.
v2.0 introduces cross-file dataflow analysis: trace user input from an HTTP handler in one file through helper functions and into a SQL query in another file. This is the kind of analysis that pattern-matching tools miss entirely.
Cross-File Taint Analysis
Most open-source SAST tools operate on single files. Code Pathfinder v2.0 tracks tainted data across file boundaries:
app.py:5 user_input = request.get("query") ← Source: user-controlled input
↓ calls
db.py:12 cursor.execute(query) ← Sink: SQL execution
The engine builds a Variable Dependency Graph (VDG) per function, then connects them through inter-procedural taint transfer summaries. When user_input flows into a function parameter in another file, the taint propagates through the call graph to the sink.
How It Works
Source Code → Tree-sitter AST → Call Graph → Variable Dependency Graph → Taint Analysis → Findings
↓
Inter-procedural
Taint Summaries
(cross-file flows)
- Parse: Tree-sitter builds ASTs for Python, Dockerfiles, and Docker Compose files
- Index: Extract functions, call sites, parameters, and assignments into a queryable call graph
- Analyze: Build VDGs per function, resolve inter-procedural flows, run taint analysis
- Detect: Python-based security rules query the graph to find source-to-sink paths
- Report: Output findings as text, JSON, SARIF (GitHub Code Scanning), or CSV
190 Security Rules, Ready to Use
Rules download from CDN automatically. No need to clone the repo or manage rule files.
| Language | Bundles | Rules | Coverage |
|---|---|---|---|
| Python | django, flask, aws_lambda, cryptography, jwt, lang, deserialization, pyramid | 158 | SQL injection, RCE, SSRF, path traversal, XSS, deserialization, crypto misuse, JWT vulnerabilities |
| Docker | security, best-practice, performance | 37 | Root user, exposed secrets, image pinning, multi-stage builds, layer optimization |
| Docker Compose | security, networking | 10 | Privileged mode, socket exposure, capability escalation, network isolation |
# Scan with a specific bundle
pathfinder scan --ruleset python/django --project .
# Scan with multiple bundles
pathfinder scan --ruleset python/flask --ruleset python/jwt --project .
# Scan a single rule
pathfinder scan --ruleset python/PYTHON-DJANGO-SEC-001 --project .
# Scan all rules for a language
pathfinder scan --ruleset python/all --project .
Browse all rules with examples and test cases at the Rule Registry.
MCP Server for AI Coding Assistants
Code Pathfinder runs as an MCP server, giving Claude Code, Cursor, Cline, and other AI assistants access to call graphs, data flows, and security analysis. More context than LSP, focused on security and code structure.
pathfinder serve --project .
The MCP server exposes tools for querying the code graph: find callers/callees, trace data flows, search for patterns, and run security rules — all available to the AI assistant during code review or development.
Write Custom Rules
Security rules are Python scripts using the PathFinder SDK. Define sources, sinks, and sanitizers — the dataflow engine handles the analysis.
Here's a real rule from the repo (PYTHON-DJANGO-SEC-001) that detects SQL injection in Django:
from codepathfinder import calls, flows, QueryType
from codepathfinder.presets import PropagationPresets
class DBCursor(QueryType):
fqns = ["sqlite3.Cursor", "psycopg2.extensions.cursor"]
match_subclasses = True
@python_rule(
id="PYTHON-DJANGO-SEC-001",
name="Django SQL Injection via cursor.execute()",
severity="CRITICAL",
cwe="CWE-89",
)
def detect_django_cursor_sqli():
return flows(
from_sources=[
calls("request.GET.get"),
calls("request.POST.get"),
],
to_sinks=[
DBCursor.method("execute").tracks(0),
calls("cursor.execute"),
],
sanitized_by=[calls("escape"), calls("escape_string")],
propagates_through=PropagationPresets.standard(),
scope="global", # cross-file taint analysis
)
# Run your custom rules
pathfinder scan --rules ./my_rules/ --project .
Explore all 190 rules in the rules/ directory or browse the Rule Registry. See the rule writing guide and dataflow documentation to write your own.
See the rule writing guide and dataflow documentation for more.
Installation
Homebrew (Recommended)
brew install shivasurya/tap/pathfinder
pip
Installs the CLI binary and Python SDK for writing rules.
pip install codepathfinder
Docker
docker pull shivasurya/code-pathfinder:stable-latest
docker run --rm -v "$(pwd):/src" \
shivasurya/code-pathfinder:stable-latest \
scan --ruleset python/all --project /src
Pre-Built Binaries
Download from GitHub Releases for Linux (amd64, arm64), macOS (Intel, Apple Silicon), and Windows (x64).
From Source
git clone https://github.com/shivasurya/code-pathfinder
cd code-pathfinder/sast-engine
gradle buildGo
./build/go/pathfinder --help
Usage
# Scan with text output (default)
pathfinder scan --ruleset python/all --project .
# JSON output
pathfinder scan --ruleset python/all --project . --output json --output-file results.json
# SARIF output (GitHub Code Scanning)
pathfinder scan --ruleset python/all --project . --output sarif --output-file results.sarif
# CSV output
pathfinder scan --ruleset python/all --project . --output csv --output-file results.csv
# Fail CI on critical/high findings
pathfinder scan --ruleset python/all --project . --fail-on=critical,high
# MCP server mode
pathfinder serve --project .
# Verbose output with statistics
pathfinder scan --ruleset python/all --project . --verbose
GitHub Action
name: Code Pathfinder Security SAST Scan
on:
pull_request:
permissions:
security-events: write
contents: read
pull-requests: write
jobs:
security-scan:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
with:
fetch-depth: 0
- name: Run Security Scan
uses: shivasurya/code-pathfinder@v2.1.1
with:
ruleset: python/all, docker/all, docker-compose/all
verbose: true
pr-comment: ${{ github.event_name == 'pull_request' }}
pr-inline: ${{ github.event_name == 'pull_request' }}
github-token: ${{ secrets.GITHUB_TOKEN }}
- name: Upload SARIF
uses: github/codeql-action/upload-sarif@v4
if: always()
with:
sarif_file: pathfinder-results.sarif
See the full example: .github/workflows/code-pathfinder-scan.yml
| Input | Description | Default |
|---|---|---|
rules |
Path to local Python rule files or directory | - |
ruleset |
Remote ruleset(s), comma-separated (e.g., python/all, docker/security) |
- |
project |
Path to source code | . |
output |
Output format: sarif, json, or csv |
sarif |
output-file |
Output file path | pathfinder-results.sarif |
fail-on |
Fail on severities (e.g., critical,high) |
- |
verbose |
Enable verbose output | false |
debug |
Enable debug diagnostics with timestamps | false |
skip-tests |
Skip test files | true |
refresh-rules |
Force refresh cached rulesets | false |
disable-metrics |
Disable anonymous usage metrics | false |
python-version |
Python version to use | 3.12 |
pr-comment |
Post summary comment on pull request | false |
pr-inline |
Post inline review comments for critical/high findings | false |
github-token |
GitHub token (required when pr-comment or pr-inline is enabled) |
- |
no-diff |
Disable diff-aware scanning (scan all files) | false |
Either rules or ruleset is required.
Supported Languages
| Language | Analysis | Status |
|---|---|---|
| Python | Cross-file dataflow, taint analysis, call graphs | Stable |
| Dockerfile | Instruction analysis, security patterns | Stable |
| Docker Compose | Configuration analysis, security patterns | Stable |
| Go | AST analysis, call graphs | Coming soon |
Contributing
Contributions are welcome. Read the Contributing Guide for setup instructions, how to run tests locally, and the PR process.
Pushing an in-product announcement
In-product announcements (workshops, blog posts, security advisories) are
managed via release/latest.json. Add an entry to announcements[],
open a PR, and once it merges to main the publish workflow uploads the
manifest to the CDN within ~60 seconds. See the version-update-check tech
spec for the schema and version_range semantics.
All contributors must sign the Contributor License Agreement (CLA) before any pull request can be merged.
License
Questions sur Code Pathfinder MCP
Comment ajouter Code Pathfinder MCP à Claude Code ?
Exécutez claude mcp add code-pathfinder -- uvx codepathfinder dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Code Pathfinder MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils le MCP server Code Pathfinder expose-t-il ?
Il expose des outils pour interroger le graphe de code : trouver les appelants et les appelés, tracer les flux de données, rechercher des patterns et exécuter des règles de sécurité.
Comment démarrer le MCP server Code Pathfinder ?
Lancez la commande pathfinder serve avec le flag --project pointant vers votre base de code.
Quels assistants de codage IA sont compatibles avec Code Pathfinder ?
Il fonctionne avec Claude Code, Cursor, Cline et d'autres assistants IA prenant en charge le MCP.
Quels langages Code Pathfinder prend-il en charge ?
Python, Dockerfile et Docker Compose sont stables ; l'analyse AST et les graphes d'appels pour Go arriveront prochainement.
Ai-je besoin d'une clé API ou d'un compte cloud pour l'utiliser ?
Non, les scans s'exécutent localement sans nécessiter de fichiers de configuration, de clés API ou de comptes cloud.