Aifp MCP Server

Database-driven FP enforcement and project management for AI-maintained codebases

Local serverstdioPython

What is the Aifp MCP server?

Database-driven FP enforcement and project management for AI-maintained codebases. That is what the aifp mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

Traditional programming paradigms were designed for humans. AIMFP is optimized for AI-human collaboration:

Getting it running

aimfp on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • Database — driven project management** (persistent state, instant context retrieval)
  • Directive — based AI guidance** (deterministic workflows, automated compliance)
  • Example — Building a web server, calculator library, data processor
  • directives — All FP, project, and user preference directives (workflows, keywords, thresholds)
  • helper_functions — Database, file, Git, and FP utilities organized across multiple registry files
  • directive_helpersMany-to-many junction table mapping directives to their helper functions with execution metadata
  • categories — Directive groupings (purity, immutability, task management, etc.)
  • directive_flow — Status-driven directive navigation and routing
  • Tool — All helpers are exposed as MCP tools (AI calls directly via MCP)
  • Sub — helper** (is_sub_helper = TRUE): Internal utility called by other helpers only (not exposed to AI)
  • Production — Users query aimfp_core.db (pre-populated), NOT JSON files
  • project — High-level metadata (name, purpose, goals, status, user_directives_status, last_known_git_hash)

What it needs from you

Configuration is passed through the environment: PYTHONPATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

  • Python 3.11+ (required for type hint syntax used throughout)

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Aifp.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

This sits in the database access group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Aifp's toolset — Database, Directive, Example and 11 more — is a fair guide to whether it matches your workflow. It is maintained by aryanduntley; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
Databasedriven project management** (persistent state, instant context retrieval)
Directivebased AI guidance** (deterministic workflows, automated compliance)
ExampleBuilding a web server, calculator library, data processor
directivesAll FP, project, and user preference directives (workflows, keywords, thresholds)
helper_functionsDatabase, file, Git, and FP utilities organized across multiple registry files
directive_helpers**Many-to-many junction table** mapping directives to their helper functions with execution metadata
categoriesDirective groupings (purity, immutability, task management, etc.)
directive_flowStatus-driven directive navigation and routing
ToolAll helpers are exposed as MCP tools (AI calls directly via MCP)
Subhelper** (is_sub_helper = TRUE): Internal utility called by other helpers only (not exposed to AI)
ProductionUsers query aimfp_core.db (pre-populated), NOT JSON files
projectHigh-level metadata (name, purpose, goals, status, user_directives_status, last_known_git_hash)
notesRuntime logging with optional directive context (source, severity, directive_name)
typesAlgebraic data types (ADTs)

How to install the Aifp MCP server

{
  "mcpServers": {
    "aifp": {
      "command": "uvx",
      "args": ["aimfp"],
      "env": {
        "PYTHONPATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Python 3.11+ (required for type hint syntax used throughout)
VariableDescriptionRequired
PYTHONPATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Aifp to Database.
  • Use Aifp to Directive.
  • Use Aifp to Example.

Frequently asked questions

It connects Aifp to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (Database, Directive, Example, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Aifp directly.