6jWB ddZddlZddlZddlZddlZddlZddlmZddlm Z ddl m Z eejjddjZedZed Zej$j'dd  dd lmZmZd Z ddlmZd Ze dZdede efdZej?d&dede defdZ!ej?d&dede defdZ"ej?dedefdZ#ej?defdZ$ej?defdZ%ej?d'dedede e&defdZ'ej?d(dede defdZ(ed Z) ddl*m+Z,e,jZd!e)Z.e,j^e.Z0e.jbjee0d Z3ej?d)dede d"e6d#e def d$Z7e8d%k(rejsyy#e$rd ZYzwxYw#e$rd ZYwxYw#e4$rZ5d Z3dZ0YdZ5[5cdZ5[5wwxYw)*u Aria-Brain MCP-Server (V5 Sprint 6, 2026-05-09) Exposes Aria-Brain as MCP tools: - brain_search(query, top_n) — Hybrid BM25-Search via aria-brain-search.py - memory_search(query) — grep on /root/.claude/projects/-/memory/ - read_brain_file(rel_path) — direct read with path validation - list_brain_folders() — show folder structure of 02-Wissen - brain_status() — quick stats (files, total bytes, last commit) Uses FastMCP from official MCP Python SDK. Run via: claude --mcp-server aria-brain (configured in /root/.claude/mcp.json). Path security: nur Pfade unter /root/aria/brain/ akzeptiert. N)Path)Optional)FastMCP ARIA_BRAINz/root/aria/brainz/root/.claude/projects/-/memoryz'/root/aria/scripts/aria-brain-search.pyz/root/aria/scripts)atomic_write_text file_lockTF) scan_contentz aria-brainrel_pathreturnc|syt|z j} |jt|S#t$rYywxYw)zKStelle sicher, dass rel_path unter BRAIN_ROOT bleibt (kein Path-Traversal).N) BRAIN_ROOTresolve relative_to ValueError)r candidates $/root/aria/mcps/aria-brain/server.py_validate_pathr2sJ h&//1Ij)  s 3 ??querytop_nc Ntjs dtS|jsytdt |d} t j dtt|dt|gddditjd tti }|jj}|jd k7r-d |jd |jjddS|xsdS#t j$rYyt$r}d|cYd}~Sd}~wwxYw)u Hybrid-Search im Aria-Brain (BM25 + Recency + Frontmatter + Path-Match). Liefert Top-N Treffer mit Pfad, Score, kurzem Kontext. Nutze für: konzeptuelle Fragen, Pattern-Lookup, „wo steht etwas zu X". z"ERROR: Search script not found at ERROR: Empty querypython3--topT rcapture_outputtexttimeoutenvrzSearch exited : NzKeine Treffer.zERROR: Search timeout (>10s)ERROR: ) SEARCH_SCRIPTexistsstripmaxmin subprocessrunstrosenvironr stdout returncodestderrTimeoutExpired Exception)rrresultoutexcs r brain_searchr7>s    !3M?CC ;;=# 3ub> "E M*E7CJ G=2::=|S_=  mm!!#    !#F$5$5#6b9L9L9NtPS9T8UV V&&&  $ $.- s+B+C82C88D$ D$DD$D$max_hitsc|jsytjs dtStjd|j Dcgc]}t |dkDs|}}|sydjd|dd D}g}ttjd D]} |jd }tj||tjs<|j}tjd |tj} | r"| j!djddnd} |j#d dD cgc]} | js| c} dd} dj| dd} |j%|| | ft ||k\sn|sd|Sdjd|DScc}w#t$rY2wxYwcc} w)u Grep-Search auf Memory-Index (`/root/.claude/projects/-/memory/`). Liefert Filename + Description + Erste Zeilen pro Treffer. Nutze für: konkrete Memory-Lookup (LRN-Records, Feedback, Project-Notes, User-Profile-Fakten). rzERROR: Memory dir not found at z\W+z?ERROR: Query contains only short words; need >3 chars per token|c3FK|]}tj|ywN)reescape).0ks r z memory_search..os:ryy|:s!N*.mdignoreerrorsz^description:\s*(.+)$r  iuKeine Treffer für Pattern:  c3:K|]\}}}d|d|d|yw)z**z** z N)r@ndss rrBz memory_search..s.%,Q1"QCvaSQC s)r' MEMORY_DIRis_dirr>splitlowerlenjoinsortedglob read_textOSErrorsearch IGNORECASEstem MULTILINEgroup splitlinesappend)rr8wkeywordspatternhitsfcontentname desc_matchdescl body_linessnippets r memory_searchro^s ;;=#    0 ==88FEKKM:Iac!fqjIHI Phh:Xbq\::G D JOOF+ ,  kkk2G 99Wgr}} 566D#;WbllSJ8B:##A&,,.t4D%,%7%7%9!B%?M1779!MbqQJii +DS1G KKtW- .4yH$  -gY77 ;;04 /J    Ns*G)G1GG#+G# G G c6t|}|s d|dtdS|jsd|S|jsd|S |j d}t |d kDr|d d d t |d zS|S#t $r}d|d |cYd }~Sd }~wwxYw)z Liest eine Datei aus dem Brain (`/root/aria/brain/`). Pfad muss relativ zum Brain-Root sein (z.B. `SOUL.md`, `02-Wissen/foo.md`). Path-Traversal wird verhindert. Liefert max 50 KB, danach truncated mit Marker. ERROR: Invalid path ''. Must be relative under .zERROR: File not found: zERROR: Not a regular file: replacerFzERROR reading r"NiPz( [TRUNCATED at 50 KB. Total file size: z bytes])rr r&is_filerZr[rV)r targetrhr6s rread_brain_filerwsH %F &xj0J:,VWXX ==?(11 >> ,VH550"")"4 7|fw$NsSZ|n\c"ddd N 0xr#//0sA== BB BBc *tjs dtSdtdg}ttjd}|j dt |d|D]>}|j j}|j d|jd|d @ttjDcgc]1}|js|jjd r0|3c}}|j d t |d|D]}td |jdD}|j d|jd |d|jdk(sVt|jDcgc]}|js|c}}|D]E}td|jdD} |j d|jd | dGdj|Scc}wcc}w)zq Zeigt Folder-Struktur von /root/aria/brain/ und 02-Wissen/-Sub-Folders. Plus File-Count pro Folder. ERROR: Brain root not found at z Brain-Root: rKrDz Root-Files ():  (zB)rsz Folders (c3 K|]}dywrNrNr@_s rrBz%list_brain_folders..s5!5 u/ — z markdown filesz 02-Wissenc3 K|]}dywr~rNrs rrBz%list_brain_folders..s9Qq9rz z files)r rSrXrYrbrVstatst_sizeriiterdir startswithsumrglobrW) outputmd_filesrgsizerPfolders files_countrQ sub_folderssf_counts rlist_brain_foldersrs    0 ==ZL+ ,Fjoof-.H MMLXr23 /vvx 166("TF"-./ !3!3!5cAAFFL]L]^aLbacdG MMKG ~R01  E5QWWV_55  166(& _EF 66[  QYY[!GAHHJ!!GHK  E9!&&.99 QVVHF8*FCD E E 99V d"HsH H 5H  H #H c tjs dtSd}d}tjdD]4}d|jvr |dz }||j j z }6d} tjgdtddd }|jjxsd }dtd|d|d|dz dd| S#t $rYwxYw#t$r}d |d }Yd}~  ,)]+$ XkD.@-EF!  $!    -%cU!,-s* "C1>C CC C0 C++C0rh frontmatterc~ t|}|s d|dtdS|jtj gd}dg}t fd|Dst fd|Drd St sy |j jd d |}|r|jjd sd g}|jD]O\}} t| ttfrtjt| } |j!|d | Q|j!d dj#|dz|z}|j%|j&dz} t)| 5t+||dddd|dt/|dS#1swYxYw#t,$r} d| cYd} ~ Sd} ~ wwxYw)u' Schreibt eine Markdown-Datei ins Brain. Atomar (mkstemp + fsync + os.replace) + File-Lock (Hermes-Pattern aus KAR-125). Pfad-Validierung wie bei read_brain_file. Wenn `frontmatter` übergeben: YAML-Block wird auto-vorne eingefügt (nur wenn content keinen `---`-Header hat). Use-Cases: - Daily-Log-Append - Brain-Note neu anlegen - Memory-File aktualisieren KEINE Schreibrechte für: 04-Feedback/ (Kais' Eigentum), Schutzzonen (08-Finanzen, 09-Buch-Aria, 11-Legal — falls existent), .git/, .archive/. rqrrrs)z 04-Feedback/z 08-Finanzen/z 09-Buch-Aria/z 11-Legal/z.git/z .archive/c3@K|]}j|ywr=rr@prels rrBzbrain_write..s 93>>!  9sc3&K|]}|v ywr=rNrs rrBzbrain_write..s@fac@fsz(ERROR: write to protected zone refused: z@ERROR: aria_atomic_write nicht importierbar (KAR-125 dependency)T)parentsexist_ok---r"rKrLz.lockNzERROR atomic write: z WRITTEN: r|z chars))rr ras_posixany _HAS_ATOMICparentmkdirlstripritems isinstancelisttuplejsondumpsrbrW with_suffixsuffixrrr3rV) r rhrrvforbidden_prefixesforbidden_containsbodyfm_linesrAv lock_pathr6rs @r brain_writers"H %F &xj0J:,VWXX   Z ( 1 1 3C`% 9&8 99S@fSe@f=f9#?? Q MMt4 D7>>+66u=7%%' )DAq!dE]+JJtAw' OOqcA3K ( ) yy"V+g5""6==7#:;I, y ! , fd + ,vhbT 7 33  , , ,%cU++,s6& F$1 F>F$F!F$$ F<-F71F<7F< filter_yamlci}|jjD]k}|j}|rd|vr|jd\}}}|jj||jj<m|syg}tj dD]}t d|jDr! |jdd} | jjdsU| jd d } | d krm| d | j} i} | jD]=} d| vs| jd\}}}|j| |j<?d }i}|jD]1\}}| j|d }|dk(r||vr d}n||vrd}n|||<3|s|jtj!}d }t#j$d| d| t"j&t"j(z}|r=|j+djjdjd}|j-|||ft/||k\sn|sd|Sdt/|dg}|D]G\}}}|j-d||r|j-d|dd|j-d|Idj1|S#t$rYbwxYw)u Sucht Brain-Files anhand Frontmatter-Filter. `filter_yaml` ist key:value-Pairs, je Zeile, z.B.: type: research status: aktiv tags: aria-radar Match-Logik: - String-Werte: case-insensitive substring oder exact match - `tags:` matched wenn Filter-Tag in der Tag-Liste der Note ist - Multiple Filter sind AND-verknüpft Liefert: Pfade + Title (aus Frontmatter) + die gematchten Felder. :zCERROR: no filters provided. Format: 'type: research\nstatus: aktiv'rDc3JK|]}|jdxs|dvyw)rs) __pycache__Nr)r@parts rrBz*brain_frontmatter_query..?s'UDts#?t/?'??Us!#zutf-8rt)encodingrGrz ---rTrItagsFz^title:\s*(.+)$Nr"'uKeine Treffer für Filter: zFound z matches:r{z title: Pz matched: rK)r'ra partitionrUr rrrrZr[rrfindrgetrrr>r\r_r]r`rbrVrW)rr8filterslinerArrrfmdrfm_endfm_block fm_fieldsflinefkfv matches_allmatchedpresentrtitlemliness rbrain_frontmatter_queryr!s"G!!#..07zz|s$ ..%1a%&WWY__%6 !" 7 U Dv&' UBHHU U  <<<CD{{}''. 7A& A: &>'') ((* 3Ee|!OOC0 Ar(* "((*% 3 mmo "FBmmB+GV|W$"'KW$"'K!GBK " ..,557CE ,d7FmR\\BMM=YZA ((*005;;C@ KKeW- .4yH$O'R ,WI66c$i[ * +E#0UG r#Z  LL;uSbzl3 4 }WI./ 0 99U Y   s K?? L  L z&/root/aria/scripts/aria-brain-think.pyaria_brain_thinkno_llm stale_daysc tjs dtS|jsytdt |d}t r}t rv t j||| |}g}|d}|jdr|d|dd |d d z }|jd |d |d|jd|j|d|jd|jdg}|r[|jdt|d|D]'}|jd|dd|dd|ddd )|jd|jdi} | jdg} | rY|jdt| d| D]%} |jd| dd | d!d"| d#'|jd| jd$g} | r#|jd%d&j| | jd'g} | rb|jd(t| d| D].}|jdd)j|d*d+|d,0|jd| jd-g}|r#|jd.d&j|dj|S d1tt|d2t|d3t|g}|r|jd4tj|d5d5d6it j"d7tt$i8}|j&j}|j(d9k7r-d:|j(d+|j*jd0d;S|xsd|cYd0}~Sd0}~wwxYw)?uw Synthesis + Gap-Analysis über das Aria Brain (KAR-622). Im Gegensatz zu brain_search (gibt Treffer-Liste) liefert brain_think: - Eine synthetisierte Antwort mit zitierten Quellen ([slug]) - GAP ANALYSIS: STALE (veraltete Treffer), UNCITED (unbelegte Aspekte), CONTRADICTION (widersprüchliche Dokumente), MISSING (unbekannte Aspekte) - LLM-Synthese wenn ein Key verfügbar ist (Gemini-Flash → DeepSeek → GPT-4o-mini), sonst deterministisch extraktiv. Nutze für: "Was weiß das Brain über X?", "Gibt es Widersprüche zum Thema Y?", "Wo hat das Brain Lücken zu Z?". Args: query: Frage oder Thema für die Synthese top_n: Anzahl der Treffer (1-20, Default 7) no_llm: True = deterministischer Extraktions-Modus ohne LLM-Aufruf stale_days: Alter in Tagen ab dem eine Note als STALE gilt (Default 90) z!ERROR: Think script not found at rrr)rtopuse_llmrmode llm_providerr|/ llm_modelrz[think/z ] query: rKANSWERanswerrI citationsz CITATIONS (rzz [slugz] brain/pathz (score=scorez.3fgapsstalez GAP STALE (r{u — age_daysud — reasonuncitedz GAP UNCITED: z, contradictionzGAP CONTRADICTION (z vs pathsr"signalmissingz!GAP MISSING (Brain kennt nicht): zERROR in think (in-process): Nrrz --stale-daysz--no-llmT-rrrz Think exited r#zKeine Antwort generiert.zERROR: Think timeout (>45s)r$) THINK_SCRIPTr&r'r(r) _HAS_THINK _think_modthinkrrbrVrWr3r,r*r+r-r.r r/r0r1r2)rrrrr4rmode_strrcrrrQrrrr6cmdr5s r brain_thinkrs*    2<.AA ;;=# 3ub> "Ej/ 9%%" % &FEf~Hzz.)b!7 8&:M9NaPP LL78*IeWB? @ LL " LL) * LL  ;3I {3y>*:"=>"`ALL3qyk!F)HQwZX[L\\]!^_` R ::fb)DHHWb)E {3u:,b9:ZALL2ai[a m_F1X;-!XYZ R hhy"-G }TYYw-?,@AB HH_b9M 23}3E2FbIJ&PALL2fkk!G*&=%>b8 !NOP R hhy"-G @7AS@TUV99U# # #l+UGSZs:0  JJz " =2::=|S_=  mm!!#    !"6#4#4"5R 8K8K8Mds8S7TU U000' 923%8 8 9(  $ $-, sJI4N C N7N7 N4%N/)N4/N47O# O#OO#O#__main__)rCr=)r)FZ):__doc__r-sysr*rr>pathlibrtypingrmcp.server.fastmcprr.rrr rRr%rinsertaria_atomic_writerrr ImportErroraria_prompt_injection_scannerr _HAS_SCANNERmcpr,rtoolintr7rorwrrdictrrrimportlib.utilutil_iluspec_from_file_location _think_specmodule_from_specrloader exec_modulerr3_think_import_errboolr__name__r+rNrrs   & "**../AB C K K M 3 4 >? '(>K :Ll S Xd^ C >&&&C& &Rcc 2C D%c% %P/4#/4/4(4./4TW/4 /4dMMMSM M`<= !.$../A<PK&&&{3J"":.J bsb3bDbcb[^b bJ zGGICKL^ JJs= HH?AHH  H HHH/!H**H/