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.96.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.96-py3-none-any.whl (110.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: defenter_proxy-0.0.96.tar.gz
  • Upload date:
  • Size: 89.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"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.96.tar.gz
Algorithm Hash digest
SHA256 24ac0189d98d2ac55354f8e1fc8a0b6d3e9cc4d35a869c15245e29968a4587f1
MD5 ef4d2f0075e3bdcbdf5eb760e053afce
BLAKE2b-256 a564d7b919125323c85c7a9c6a1222a6e2e0e985625b0fe1fa1c5e4673e59772

See more details on using hashes here.

File details

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

File metadata

  • Download URL: defenter_proxy-0.0.96-py3-none-any.whl
  • Upload date:
  • Size: 110.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"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.96-py3-none-any.whl
Algorithm Hash digest
SHA256 7ea0c1b30e26409a10eb59e46fe05e5a8e724e5157ecab584a210c7cb687d4d2
MD5 0ae9dc6adead653abb6ab21e9039cbd9
BLAKE2b-256 6e5813551cbf5a3eb15dba7555b0af70992cf6b787f3d83174a23e81968bbe9e

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