Code Pathfinder MCPサーバー
✓ 検証済みAIアシスタントがPythonプロジェクトに対して、コールグラフのクエリ、データフローのトレース、セキュリティルールの実行を行えるようにします。
別名 shivasurya/code-pathfinder, code-pathfinder, codepathfinder
- スター
- 143
- ツール
- —
- ダウンロード数(30日間)
- 426
- 最新バージョン
- 2.1.1
- 最終コミット
- 2026年7月10日
- ライセンス
- Apache-2.0
Code Pathfinder MCPとは
Code PathfinderはMCPサーバーです。 AIアシスタントがPythonプロジェクトに対して、コールグラフのクエリ、データフローのトレース、セキュリティルールの実行を行えるようにします。.
プロジェクトのREADMEから生成された概要
Code Pathfinder MCP server について
セキュリティエンジニアや開発者は、Code Pathfinderを使用して、Pythonプロジェクト、Dockerfile、およびDocker Composeファイルに対して高度な静的解析を行うことができます。このMCP serverをClaude Code、Cursor、ClineなどのAIコーディングアシスタントに統合することで、AIにコード構造やセキュリティ脆弱性に関する高度な理解を与えることが可能です。このサーバーにより、AIは開発ワークフローの中で直接、コールグラフのクエリ、システム内のデータ移動のトレース、および特定のセキュリティルールの実行を行えます。
標準的なパターンマッチングツールとは異なり、このエンジンはファイル間をまたぐデータフロー解析を実行し、あるファイルのソースから別のファイルのシンクへと流れる汚染されたデータ(tainted data)を追跡します。Tree-sitterを使用して抽象構文木(AST)を構築し、変数依存グラフ(Variable Dependency Graph)を作成することで、複雑な相互作用をマッピングします。システムはAPIキーやクラウドアカウントを必要とせず、Homebrewまたはpip経由でインストールすれば完全にローカルで動作します。SQLインジェクションやRCEなどの一般的な問題をカバーする190個の即時利用可能なルールが付属しており、これらはCDNから自動的にダウンロードされます。
できること
- 1ファイル間をまたぐデータフローのトレースユーザー入力がHTTPハンドラーから様々な関数を経由して、データベースクエリに到達するかどうかをAIアシスタントに追跡させます。
- 2Pythonのセキュリティ脆弱性の監査AIアシスタントに特定のセキュリティルールセットを実行させ、Pythonコードベース内のSQLインジェクションやRCEなどの脆弱性を特定させます。
- 3コードベース構造のクエリ生成されたコールグラフを使用して、特定の関数に対するすべての呼び出し元または呼び出し先をAIアシスタントに検索させます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Code Pathfinder MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにCode Pathfinder MCPをインストール
$ claude mcp add code-pathfinder -- uvx codepathfinderCursorにCode Pathfinder MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"code-pathfinder": {
"command": "uvx",
"args": [
"codepathfinder"
]
}
}
}VS CodeにCode Pathfinder MCPをインストール
.vscode/mcp.json
{
"servers": {
"code-pathfinder": {
"type": "stdio",
"command": "uvx",
"args": [
"codepathfinder"
]
}
}
}VS Code CLIにCode Pathfinder MCPをインストール
$ code --add-mcp '{"name":"code-pathfinder","type":"stdio","command":"uvx","args":["codepathfinder"]}'Claude DesktopにCode Pathfinder MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"code-pathfinder": {
"command": "uvx",
"args": [
"codepathfinder"
]
}
}
}CodexにCode Pathfinder MCPをインストール
$ codex mcp add code-pathfinder -- uvx codepathfinderCodex config.tomlにCode Pathfinder MCPをインストール
~/.codex/config.toml
[mcp_servers.code-pathfinder] command = "uvx" args = ["codepathfinder"]
Gemini CLIにCode Pathfinder MCPをインストール
$ gemini mcp add -s user code-pathfinder uvx -- codepathfinderGemini settings.jsonにCode Pathfinder MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"code-pathfinder": {
"command": "uvx",
"args": [
"codepathfinder"
]
}
}
}自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている未チェック
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見るWebsite · 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
Code Pathfinder MCPのよくある質問
Code Pathfinder MCPをClaude Codeに追加するには
ターミナルでclaude mcp add code-pathfinder -- uvx codepathfinderを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Code Pathfinder MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Code Pathfinder MCP serverはどのようなツールを提供しますか?
コードグラフをクエリするためのツールを提供します。具体的には、呼び出し元(caller)と呼び出し先(callee)の特定、データフローのトレース、パターン検索、およびセキュリティルールの実行が可能です。
Code Pathfinder MCP serverを起動するにはどうすればよいですか?
pathfinder serveコマンドを、対象のコードベースを指す--projectフラグを付けて実行してください。
どのAIコーディングアシスタントでCode Pathfinderを使用できますか?
Claude Code、Cursor、Cline、およびMCPをサポートするその他のAIアシスタントで使用できます。
Code Pathfinderがサポートしている言語は何ですか?
Python、Dockerfile、Docker Composeが安定版として利用可能です。GoのAST解析とコールグラフ機能も近日公開予定です。
使用にあたってAPIキーやクラウドアカウントは必要ですか?
いいえ、スキャンはローカルで実行されるため、設定ファイルやAPIキー、クラウドアカウントは一切不要です。