# AIMFP

> AIMFP is an open-source MCP server for developer tools. MCP server that tracks a project in SQLite so AI keeps functional-style code consistent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/aryanduntley/aimfp
- **MCP Registry name:** io.github.aryanduntley/aimfp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add aimfp -- uvx aimfp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "aimfp": {
      "command": "uvx",
      "args": [
        "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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/aimfp
