Skip to main content

Defenter proxy

Project description

Defenter

Real-time semantic security for AI coding agents and MCP tools in VS Code, Claude Code and Cursor.

Defenter monitors every prompt, every coding agent tool call, every MCP server call, and key file and shell operations in your IDE. It acts as a semantic policy broker that understands what agents are doing, not just where they send data, so you can use AI coding agents without leaking secrets or customer data.


🚀 How to use

The simplest way to use Defenter is to install the VS Code or Cursor extension:

Once installed, the extension automatically intercepts and protects:

  • MCP server calls
  • Coding agent prompts and responses
  • File reads and shell commands triggered by the agent

No manual MCP configuration is needed.


Overview

Defenter is a semantic policy broker for AI coding agents. It adds an intelligent security layer inside your IDE that:

  • Intercepts every coding agent prompt and action
  • Wraps every MCP tool call and response
  • Analyzes the payload for sensitive information and risky behavior in real time
  • Enforces your security policies with allow, redact, or block decisions

Traditional security tools cannot see what an agent is about to share or execute. They look at apps and destinations, not at the intent and content of an agent’s actions.

Defenter bridges this gap by:

  • Preventing data leaks and context contamination
  • Providing clear, visual monitoring of every agent decision

Architecture and how it works

This repository contains the Defenter proxy and related components that secure MCP and coding agent traffic.

Defenter is built as a Python based proxy and local middleware that the IDE extension uses to enforce policy. At a high level:

  • Local middleware layer

    • Runs on the developer machine
    • Hooks coding agent prompts, file reads, and shell executions
    • Intercepts all MCP tool calls and responses
    • Performs client side redaction of secrets and PII
  • Cloud powered policy engine

    • Receives a minimal, redacted payload
    • Uses a classifier and analyzer to check for data leaks, context contamination, and prompt injection
    • Returns Allow, Redact, Need more info, or Block decisions in real time
    • Works with low latency to make sure the development flow in without friction
  • IDE integration

    • Seamless integration with VS Code and Cursor extensions
    • Shows a live monitoring view of all agent actions and Defenter decisions directly inside the IDE

Together, these pieces let you harness AI coding agents and MCP tools without compromising the security of your code, data, or workflows.


References

Python Proxy: See src/README.md for detailed implementation documentation

VSC Extension: See targets/vsc-extension/README.md for installation and user guide

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

defenter_proxy-0.0.94.tar.gz (89.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

defenter_proxy-0.0.94-py3-none-any.whl (110.0 kB view details)

Uploaded Python 3

File details

Details for the file defenter_proxy-0.0.94.tar.gz.

File metadata

  • Download URL: defenter_proxy-0.0.94.tar.gz
  • Upload date:
  • Size: 89.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.9 {"installer":{"name":"uv","version":"0.9.9"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for defenter_proxy-0.0.94.tar.gz
Algorithm Hash digest
SHA256 4046edf8f41a9d94a74533fe252af88a497c410a89a76b85bfa469060cf262e7
MD5 b8243158ad8204cf45e8067a8fc3bed9
BLAKE2b-256 fa5eea19e8e3441bcf8b8cd5413925959170621eb6cf8f6981578dd01d3aeabc

See more details on using hashes here.

File details

Details for the file defenter_proxy-0.0.94-py3-none-any.whl.

File metadata

  • Download URL: defenter_proxy-0.0.94-py3-none-any.whl
  • Upload date:
  • Size: 110.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.9 {"installer":{"name":"uv","version":"0.9.9"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for defenter_proxy-0.0.94-py3-none-any.whl
Algorithm Hash digest
SHA256 4f23d252bc8b7f8413b06e863642fee8e594d775d1637c86d2dc06a921200b6d
MD5 8c079e846fec072f1b4652dd21293cbc
BLAKE2b-256 7e8642592646a6e259e0922acfebd88a072397e378f6a19fe5a6df0de156c946

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page