Skip to content
MCP server

AIMFP

MCP server that tracks a project in SQLite so AI keeps functional-style code consistent

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.71.0
Listing updated
today

Similar MCP servers

About AIMFP

AIMFP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

AIMFP stands for AI Modular Functional Procedural programming. It is a paradigm and toolset aimed at codebases that an AI writes and maintains: pure functions, explicit data structures and no hidden state, with directives that tell the assistant how to behave. The MCP server exposes helper tools over stdio that read and write four SQLite databases, a read-only core of directives plus per-project databases for project state, user preferences and optional custom directives.

Because every file, function and dependency is recorded, the assistant can ask for a file's functions instead of re-parsing source, and context carries over between sessions. Projects follow a finite completion path with stages, milestones and tasks rather than open-ended development. The README says it works with Python, JavaScript, TypeScript, Rust, Go and others.

A second mode generates automation code from directives you write in YAML, JSON or text, such as home control or cloud management. That code runs from your own runner script by importing AIMFP as a library, so it keeps working when no AI session is open. The README says to use one AIMFP instance per project directory.

Install

Run in a terminal

claude mcp add aimfp -- uvx aimfp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "aimfp": {
      "command": "uvx",
      "args": [
        "aimfp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "aimfp": {
      "command": "uvx",
      "args": [
        "aimfp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "aimfp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "aimfp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "aimfp": {
      "command": "uvx",
      "args": [
        "aimfp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "aimfp": {
      "command": "uvx",
      "args": [
        "aimfp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Persistent project database
Files, functions, tasks and themes are tracked in SQLite across sessions.
Directive-driven guidance
Immutable directives enforce functional-programming compliance.
Completion paths
Projects are broken into stages, milestones and tasks with a defined end.
Four databases
Core directives, project state, user preferences and custom directives are kept separate.
Directive automation
Generate an automation codebase from directives written in YAML, JSON or text.
Language-agnostic
Directives adapt to Python, JavaScript, TypeScript, Rust, Go and more.

Good for

  • Keep an AI assistant consistent about project structure between sessions
  • Enforce pure-function style in generated code
  • Track tasks and milestones for a small software project
  • Generate a home or cloud automation project from written directives

Pricing

Open source

AIMFP FAQ

How is it installed?

It is published on PyPI as aimfp and runs as a stdio MCP server.

Can the automation run without an AI session?

Yes. The generated runner imports AIMFP as a library, so it runs from cron or a daemon without the MCP server.

Can I mix projects in one instance?

The README says to use one instance per project directory and separate instances for different purposes.

Does the AI write raw SQL?

No. The assistant uses helper tools such as get_functions_by_file rather than raw SQL.

Is AIMFP free?

Yes. AIMFP is open source, so you can use and self-host it for free.

How do I add AIMFP to Claude Code?

Run this command in your terminal: claude mcp add aimfp -- uvx aimfp

What are the best alternatives to AIMFP?

The closest alternatives to AIMFP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers