Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Aifp MCP

by wjabanjjversion 1.5.8i★ 4iRuns on your computerRepository ↗
Registry nameio.github.wjabanjj/aifp-mcp

How to install

What it does

Persistent memory MCP server for AI coding assistants. Chinese-first and fully local.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Search & AI memory

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6381 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6051 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2361 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity8/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness3/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score11/100

Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Aifp MCP. Follow https://mcp.popnx.com/i/wjabanjj-aifp-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 2/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Aifp MCP for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "aifp": { "command": "npx", "args": [ "-y", "aifp-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Aifp MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "aifp": {
          "command": "npx",
          "args": [
            "-y",
            "aifp-mcp"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use Aifp MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Aifp MCP or shows a Aifp MCP tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • COGNITION_LLM_API_KEY Optional LLM API key for automatic memory recognition (COGNITION_LLM_API_KEY or ANTHROPIC_API_KEY)

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Aifp MCP yet

Aifp MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Aifp MCP

  • Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)

B · Others in Search & AI memory that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Aifp MCP for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user aifp -- npx -y aifp-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Aifp MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user aifp -- npx -y aifp-mcp
  4. Type /mcp in Claude Code

    You should see Aifp MCP listed as connected

  5. Try it

    Use Aifp MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Aifp MCP or shows a Aifp MCP tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • COGNITION_LLM_API_KEY Optional LLM API key for automatic memory recognition (COGNITION_LLM_API_KEY or ANTHROPIC_API_KEY)

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Aifp MCP for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "aifp": { "command": "npx", "args": [ "-y", "aifp-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Aifp MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use Aifp MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Aifp MCP or shows a Aifp MCP tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • COGNITION_LLM_API_KEY Optional LLM API key for automatic memory recognition (COGNITION_LLM_API_KEY or ANTHROPIC_API_KEY)

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Aifp MCP for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "aifp": { "type": "stdio", "command": "npx", "args": [ "-y", "aifp-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Aifp MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use Aifp MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Aifp MCP or shows a Aifp MCP tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • COGNITION_LLM_API_KEY Optional LLM API key for automatic memory recognition (COGNITION_LLM_API_KEY or ANTHROPIC_API_KEY)

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Aifp MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user aifp -- npx -y aifp-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "aifp": {
      "command": "npx",
      "args": [
        "-y",
        "aifp-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "aifp": {
      "command": "npx",
      "args": [
        "-y",
        "aifp-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "aifp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "aifp-mcp"
      ]
    }
  }
}

Values you fill in

  • COGNITION_LLM_API_KEY secret env
    Optional LLM API key for automatic memory recognition (COGNITION_LLM_API_KEY or ANTHROPIC_API_KEY)

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
170/wk
Licencei
No licence stated
Connection
Runs on your computer
Latest versioni
1.5.8
Published to registryi
Aug 15, 2026
Code last changedi
Aug 19, 2026
Maker
wjabanjj
Packages
npm: aifp-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account wjabanjj, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 3 months ago

  • ! Caution

    Has a licence

    GitHub could not identify the licence type; open the file to check

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for aifp-mcp@1.5.8

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/wjabanjj-aifp-mcp.svg)](https://mcp.popnx.com/en/servers/wjabanjj-aifp-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Search & AI memoryi

  • More stars than 88% of the other 6430 servers in this category
  • Published to the registry more recently than 26% of the other 6430 servers in this category
  • Basic checks equal to or better than 50% of the other 6430 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Aifp MCP safe?

It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 3 months ago, and the latest version (1.5.8) reached the registry 3 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

by every-appWidely used★ 28.3KUpdated 5 days ago

Runs in the cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

by exa-labsWidely used★ 5.2KUpdated 2 months ago

Runs in the cloud✓ service owner · exa.aiTried by the PopNx team

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

by MicrosoftDocsWidely used★ 2KUpdated 12 months ago

Runs in the cloud✓ service owner · microsoft.comTried by the PopNx team

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

by proxysoulGrowing★ 1.6KUpdated 2 months ago

Runs in the cloud✓ empryo.com
Compared with similar ones
This one
Aifp MCP
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesYesYesNoNo
Basic checks2/35/52/44/44/44/4
LicenseNOASSERTIONMITMITCC-BY-4.0NOASSERTIONApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

AiFP 记忆感知系统 — MCP Server

通过 Model Context Protocol 为 AI 编程助手提供持久记忆。

English · npm · GitHub

让 Obsidian、DeepSeek Harness、Claude Code、Cursor、Codex 等一切支持 MCP 的 AI 工具拥有跨会话的持续记忆。完全本地运行,数据不出本机(默认 ~/.ai-cognition/)。

为什么选 AiFP — 一套记忆,所有 AI 共享

你受够了 AI 的"健忘"吗?

  • 聊了一上午,它忘了项目名——存了,但用不上
  • 你说"拍森",它只认 Python——说错一个字就搜不到
  • 昨天说 Docker 连不上,今天说 MySQL 连不上,它不知道是同一件事——相关的记不住
  • DeepSeek Harness 学会的,Claude Code 不知道——每个 AI 都是记忆孤岛

多数 AI 记忆系统只是存——存是存了,但用不上。AiFP 是让 AI 真正记住、想通、共享,把上面这些毛病一次解决。

先讲别人做不到的(共享):

一套记忆,所有 AI 共用。 今天 DeepSeek Harness 学会的,明天 Claude Code 还记得;Codex 攒的偏好,VS Code Copilot 不用重新问。别的记忆系统做不到——因为它们每个各记各的,互不相通。AiFP 让同电脑上所有 AI 工具共用一个大脑,记一份,处处用。

再讲它为什么好用(能力):

  • 会掂量着记——不是每句话都存。聊的东西先进"待定区",由识别器判断这条值不值得长期记住:值得才正式记下,不值得就跳过。不会一股脑全存,也不会错漏重要的。
  • 能听懂人话——你说"拍森",它知道是 Python;你说"上个月",它知道是哪个月。说错字、口语、时间词都能理解。
  • 能看出关联——昨天说"连不上数据库",今天说"改了配置还不行",它知道是同一件事的延续。还能顺着一条线索联想出相关的内容。
  • 记得清,用得上——一条记忆只留核心意思,不堆垃圾。用的时候只挑最相关的几条给你,又快又不乱。
  • 越用越懂你——你的偏好、习惯它会慢慢积累成"画像",但它分得清"事实"和"建议",不会把你的想法和它自己的混在一起。
  • 该忘的就忘——太久没用的记忆会自然淡出,重要的记忆会越来越牢。记忆库永远干净,不会变成堆不动的垃圾场。

看这些名字,就知道它不简单——记忆被做成了大脑的结构:

概念它到底在干嘛(大白话)
🧠 海马体 · 记忆感知会掂量着记——先进"待定区",识别器判断值不值得长期记住,值得才正式记下,不值得就跳过
🔗 神经元突触 · 感知链自动发现信息之间的联系,还能顺着线索找到最直接的关系
👃 嗅觉皮层 · 语义检索说错也能找到——你说"拍森",它知道你要找 Python
⚡ 共燃神经元 · 关联一起出现的东西自动绑在一起,问 A 顺带带出 B
🗣 语言中枢 · 理解懂口语、认错字、认得"上个月"是哪个月
🌊 神经扩散 · 联想回忆一条线索能联想出好几层相关的记忆
🧬 突触固化 · 记忆巩固用得越多记得越牢,从临时记忆慢慢变成长期记忆
⏳ 遗忘曲线太久不用的自然淡出,记忆库永远干净不堆积
📊 神经信号 · 置信度每条记忆带个"可信度"标尺,越靠谱的越优先给你
👤 主人认知模型 · 画像懂你这个人——偏好习惯会积累成画像,但不跟它的想法混
💪 肌肉记忆 · 跨轮复用做过的经验跨会话记得,不用每次从头学

天生为中文服务:认错字、懂口语、认时间词,全都是为中文设计的。英文为主的记忆系统,遇到"拍森找 Python"这种就抓瞎了。

默认完全私有:所有数据都存你本机,不上云、不注册、不偷偷上报。所谓"共享"只是多个工具读写同一份本地记忆——你的数据从没离开过这台电脑。

一条命令装好:npm install -g 自动帮你配好 12 个 AI 工具(Claude Code、Cursor、Windsurf、Cline、Gemini CLI、Qwen Code、Zed、VS Code Copilot、Codex CLI、Trae、DeepSeek Harness、pi-coding-agent)。

一个大脑,多个助手:今天 DeepSeek Harness 学到的,明天 Claude Code 还记得——像跟一个有记忆的同事说话,不用每次都重新自我介绍。

快速开始

npm install -g aifp-mcp

claude mcp add ai-cognition -s user -- npx aifp-mcp

重启 Claude Code 即可使用。数据存在 ~/.ai-cognition/data/cognition.db。

DeepSeek Harness (dsh) 自动接入

装完 aifp-mcp 后自动接入 dsh,无需手动执行任何 dsh 命令:

npm install -g aifp-mcp

安装时会自动检测 dsh 并写入配置(~/.dsh/cordis.patch.yml)。重启 dsh,记忆工具自动注册为 mcp__aifp__*(如 mcp__aifp__search_memories、mcp__aifp__save_memory),无需手动改任何配置。

在任意 AI 对话中安装(推荐)

不需要手动配任何东西。在 Claude Code、Codex、Cursor、DeepSeek Harness 等任意工具里直接输入:

帮我安装记忆系统:npm install -g aifp-mcp

postinstall 钩子会自动检测并配置所有已安装的 AI 工具(Claude Code、Cursor、Windsurf、Cline、Gemini CLI、Qwen Code、Zed、VS Code Copilot、Codex CLI、Trae、DeepSeek Harness、pi-coding-agent),并打印状态报告。重启工具即可使用记忆工具——AI 看到报告后会告诉你重启哪个,无需手动改任何 MCP 配置文件。

首次启动:需要下载 ~30MB 的 bge-small-zh 嵌入模型,最多阻塞 45 秒。后续启动有缓存,秒开。

本地模式 vs 服务器增强模式

AiFP 支持两种运行模式(环境变量 COGNITION_MODE,默认 remote):

本地模式完全私有(数据不出本机),但感知链工具需要连接服务器。服务器地址不随包分发,需通过官方接入渠道获取。

拿到 key 后,一条命令连上

接入地址和密钥通过官方渠道发放:联系作者(微信:zm8571806/QQ:8571806/邮箱:8571806@qq.com)订阅后发放,不随包公开。订阅到期可单独吊销,不影响其他用户。

# 1. 安装(如未安装)

npm install -g aifp-mcp

2. 一条命令连接服务器(地址和 key 由作者发放)

aifp-mcp --connect https://<官方地址> <你的64位key>

3. 重启你的 AI 工具(Claude Code / Cursor / dsh 等)

感知链 / 深度追踪 / 图扩散自动可用

断开(恢复纯本地):

aifp-mcp --disconnect

--connect 会把连接信息保存在本机 ~/.ai-cognition/server.json,之后启动自动生效,无需每次配置环境变量。

更简单:直接让你的 AI 配置

不需要手动敲命令。在 Claude Code / Cursor / Codex / dsh 等任何 AI 工具的输入框里说:

这是我的 aifp 服务器地址和 key,帮我配置:

地址:https://<官方地址>

key:<你的64位key>

AI 会自动执行 aifp-mcp --connect 并提示你重启工具。重启后感知链增强自动生效。

⚠️ key 会出现在对话记录中,介意的话配置完可在管理后台吊销重发(不影响使用)。

接入 Obsidian(笔记 ↔ 记忆双向)

Obsidian 笔记 → 记忆库(AI 可语义检索你的笔记):直接让你的 AI 导入,无需配置环境变量:

把 Obsidian 笔记导入记忆:directory = C:/Users/你/Obsidian/我的笔记库

AI 会调用 reimport_sources 同步导入(frontmatter 自动剥离、哈希去重)。以后新增笔记再说一次即可。

记忆库 → Obsidian 笔记(在 Obsidian 里看到全部记忆):让 AI 调用 export_memories_md:

把记忆导出到 Obsidian:directory = C:/Users/你/Obsidian/我的笔记库/AiFP记忆

导出的笔记带 frontmatter(type/tier/tags),Obsidian 可直接识别和检索;同名笔记自动覆盖更新,保持与记忆库同步。

MCP 工具(共 33 个)

核心工具(15 个):

工具功能链路
save_memory保存记忆(自动去重 + 向量索引)基础
search_memories双路检索:FTS5 关键词 + 向量语义逻辑链
recall_context一键回忆(直接命中 + 因果链 + 关联 + 扩散)综合链
get_memory按 ID 获取记忆详情基础
list_memories分页列出基础
trace_perception_chainBFS 感知链追踪(6 类因果)上下链
find_perception_path双向 BFS 找两条记忆间最短路径关系链
get_perception_graph_stats感知图统计关系链
diffuse_memories图扩散搜索(关联多跳)关系链
get_memory_tree层级树结构基础
get_related_memoriesHebbian 共现关联关系链
get_user_profile用户画像——聚合偏好/事实/习惯画像
observe_turn记录对话轮次到识别队列(跨平台自动记忆入口)自动
reimport_sources重新扫描外部笔记目录导入
get_stats系统统计基础

另有 18 个管理/进阶工具:consolidate_memories / share_memory / merge_memories / batch_delete / batch_update / export_memories / export_memories_md(Obsidian)/ explain_query / get_confidence_stats / scan_memory_patterns / validate_memory / get_top_experiences / deduplicate_memories / scan_observation_patterns / rotate_observation_logs / session_mine / derive_memories / flush_recognizer。

跨平台自动记忆识别

Claude Code 使用原生 hooks(100% 自动,零遗漏)。其他工具通过 observe_turn 工具 + 指令文件实现(详见 rules/ 目录):

平台配置方式自动程度
Claude Codehooks(原生)100% 自动,零遗漏
Cursor.cursor/rules/ 指令文件AI 遵守指令时自动触发
Codex CLIAGENTS.md 指令文件AI 遵守指令时自动触发
Trae项目规则(手动配置)AI 遵守指令时自动触发

指令文件告诉 AI:"每次回答完用户后调用 observe_turn 记录本轮消息"。系统会自动判断是否有值得记住的内容,不需手动决定。

核心技术

  • SQLite + FTS5 全文索引(CJK 感知,unicode61 tokenizer)
  • bge-small-zh-v1.5 向量嵌入(本地 512 维语义搜索,自动重试 + 多镜像回退)
  • Hebbian 共现矩阵("一起发射的神经元连在一起")
  • 有向因果链(6 种关系类型)
  • BFS 图扩散(沿关联多跳发现间接知识)
  • 纠错 + 消歧 + 中文时间词解析

各 AI 工具怎么接入(自动或手动)

npm install -g aifp-mcp 时自动完成(postinstall 检测所有已装 AI 工具并写入 MCP 配置)。以后新装了某个 AI 工具,跑一次即可接入:

aifp-mcp --setup   # 重新检测并配置所有 AI 工具

自动检测并配置已安装的 AI 工具(检测到才写入,不重复覆盖):

平台配置方式
Claude Code~/.claude/settings.json → mcpServers + 启动 hook
Cursor~/.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
Cline~/.config/cline/mcp_settings.json
Gemini CLI~/.gemini/settings.json → mcpServers
Qwen Code~/.qwen/settings.json → mcpServers
Zed~/.config/zed/settings.json → context_servers
VS Code Copilot%APPDATA%/Code/User/mcp.json → servers
Codex CLI~/.codex/config.toml
pi-coding-agent生成扩展到 ~/.pi/agent/extensions/aifp-memory/(pi 无内置 MCP,用扩展机制)

手动配置

Claude Code / Cursor
{

"mcpServers": { "ai-cognition": { "command": "node", "args": ["path/to/aifp-mcp/dist/index.js"] } } }

自定义数据目录
COGNITION_DATA_DIR=/path/to/data npx aifp-mcp

环境变量

变量默认值说明
COGNITION_DATA_DIR~/.ai-cognition/数据存储目录
COGNITION_MODEremotelocal 本地保底 / remote 连接服务器增强
COGNITION_SERVER_URL*(无默认,须显式配置)*远程算法服务器地址(自建)
COGNITION_API_KEY-远程模式 API 密钥
COGNITION_RECOGNIZER0设为 1 启用自动识别
COGNITION_LLM_API_KEY-识别器 LLM 密钥(OpenAI 兼容)
COGNITION_LLM_BASE_URLhttps://api.deepseek.com识别器 LLM 地址
COGNITION_LLM_MODELdeepseek-chat识别器 LLM 模型
HF_MIRRORhttps://hf-mirror.com嵌入模型下载镜像(失败自动回退 huggingface.co)
CORS_ORIGIN*HTTP 模式跨域白名单
PORT5000HTTP 端口

识别器 LLM 配置(启用自动记忆识别)

观察队列需要 LLM 判断是否值得入记忆,二选一:

# OpenAI 兼容(推荐:DeepSeek 等)

export COGNITION_RECOGNIZER=1 export COGNITION_LLM_API_KEY=你的DeepSeek密钥 export COGNITION_LLM_BASE_URL=https://api.deepseek.com # 可选,默认同左 export COGNITION_LLM_MODEL=deepseek-chat # 可选

或 Anthropic

export COGNITION_RECOGNIZER=1

export ANTHROPIC_API_KEY=sk-ant-...

不配置则只记录观察日志,自动识别不落地(AI 主动 save_memory 不受影响)。

技术栈

  • Node.js 22+ (node:sqlite) + TypeScript
  • SQLite (内置) + FTS5
  • @xenova/transformers (bge-small-zh-v1.5)
  • @modelcontextprotocol/sdk (MCP 协议)

License

专有软件 — 见 LICENSE。个人/非商业用途免费;商业用途需授权。第三方依赖遵循各自开源许可。