1. Conduid
  2. Agents
  3. Server Driftguard
MCP server · Agents

Server Driftguard

· github.com/ramailo1/mcp-server-driftguard

A Firewall for Intelligence - MCP server that enforces strict state machine for agentic coding

Unclaimed mcpmodel-context-protocolaiagentsdrift-guardstate-machinegit-notesaudit-trailscope-claimsai-guardrails
InstallView source
37Low

Scored 6 months ago · breakdown

About Server Driftguard

Server Driftguard is an MCP server in the Agents category: a Firewall for Intelligence - MCP server that enforces strict state machine for agentic coding.

Install

Claude Code
claude mcp add server-driftguard -- npx -y @soufienne/mcp-server-driftguard
npx
npx -y @soufienne/mcp-server-driftguard

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (8)

dg_claim_scope**Lock** files for exclusive editing

Parameters not published.

dg_generate_handoffCreate resume packet for next session

Parameters not published.

dg_health_checkDetect manual file tampering

Parameters not published.

dg_initInitialize DriftGuard in a repo

Parameters not published.

dg_report_intentDeclare next move (Required before checkpt)

Parameters not published.

dg_reset**Hard Reset** (Safety Valve)

Parameters not published.

dg_statusGet current tasks & state

Parameters not published.

dg_verifyRun verification command

Parameters not published.

Ask AI

✦

Ask AI about Server Driftguard

Powered by Claude · Grounded in docs

I know everything about Server Driftguard. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

🛡️ DriftGuard

A Firewall for Intelligence

npm version MCP

Strict State Machine • Zero-Loss Continuity • L3 Integrity

Getting Started • The Manifesto • Documentation

🧐 What is DriftGuard?

DriftGuard is an implementing server for the Model Context Protocol (MCP) that acts as a "Traffic Controller" for AI Agents.

Most agents suffer from "Code Drift": they edit random files, lose context, and hallucinate checkpoints. DriftGuard solves this by enforcing a Strict Recursive State Machine. An agent cannot touch code until it has:

  1. Proposed a task.
  2. Claimed a scope (locking files).
  3. Declared intent.

It is not just a tool; it is an Agreement Architecture.

🚀 Getting Started

You can run DriftGuard instantly using npx. No configuration required.

One-Command Install

npx @modelcontextprotocol/inspector npx @soufienne/mcp-server-driftguard

Manual Installation (For Development)

# 1. Clone the repository
git clone https://github.com/ramailo1/mcp-server-driftguard.git
cd mcp-server-driftguard

# 2. Install dependencies & Build
npm install
npm run build

# 3. Launch the Inspector
npm run inspect

📜 The Manifesto (Workflow)

DriftGuard enforces a linear, verifiable cycle.

graph LR
    A[Start] --> B(dg_propose_task)
    B --> C{dg_claim_scope}
    C -->|Locked| D(dg_report_intent)
    D -->|Exec| E[Edit Files]
    E --> F(dg_verify)
    F -->|Pass| G(dg_checkpoint)
    G --> A

1. 📝 Propose & Plan

Define your objective. DriftGuard creates a structured ACTIVE_PLAN.md and tracks progress.

  • dg_propose_task: Start a new mission.

2. 🔒 Scope Claiming

Prevent agents from stepping on each other's toes.

  • dg_claim_scope: Lock file paths (e.g., src/**/*.ts).
  • Integrity: Automatically snapshots file hashes (MD5) to detect "Time-Travel" hacks.

3. ⚡ Intent & Action

Never act without declaring why.

  • dg_report_intent: "I am identifying the bug in user.ts"
  • dg_verify: Run your test command. Proves the code works.

4. 💾 Checkpoint & Continuity

Save your game.

  • dg_checkpoint: Commits L3 Git Notes.
  • dg_generate_handoff: Resume Packet. Serializes the entire session state for the next agent.

🛠️ The Toolkit

Tool Purpose Phase
dg_init Initialize DriftGuard in a repo Core
dg_status Get current tasks & state Core
dg_claim_scope Lock files for exclusive editing Traffic
dg_report_intent Declare next move (Required before checkpt) Action
dg_verify Run verification command Action
dg_health_check Detect manual file tampering Integrity
dg_generate_handoff Create resume packet for next session Continuity
dg_reset Hard Reset (Safety Valve) Safety

🤝 Contributing

We welcome contributions "at the speed of thought."

  1. Fork the repo (ramailo1/mcp-server-driftguard).
  2. Create your feature branch.
  3. Commit your changes.
  4. Push to the branch.
  5. Open a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Built with ❤️ for the Age of Agents. @soufienne

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Server Driftguard

How do I install Server Driftguard?

Run claude mcp add server-driftguard -- npx -y @soufienne/mcp-server-driftguard, then add the server to your MCP client's configuration.

Is Server Driftguard safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Server Driftguard still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.