Portfolio MCP

Ein MCP-Server (Model Context Protocol), der Aiman Tariqs echten Lebenslauf und Portfolio-Inhalte als Tools und Ressourcen bereitstellt, die ein KI-Assistent direkt abfragen kann, anstatt sich darauf zu verlassen, was die Textextraktion einer Lebenslauf-PDF gerade zufällig produziert.

Füge diesen Server zu Claude Desktop, Claude Code oder Cursor hinzu und frag: „Hat Aiman RAG-Erfahrung?“ oder „Was hat sie beim Audi-Camp gebaut?“ – der Assistent ruft ein Tool auf, erhält eine fundierte Antwort direkt aus ihren eigenen Daten und kann sie zitieren.

Warum dieses Projekt

MCP ist gerade einmal ein Jahr alt und wirkt 2026 für alle, die technisch ein GitHub-Profil überfliegen, immer noch wie aktuelles, gewitztes Tooling-Wissen. Eine Handvoll Open-Source-Projekte im Stil „Portfolio mit MCP server“ existieren bereits (Mrinank-Bhowmick-2, MrinAlive) mit – dieses Projekt folgt demselben Muster, wurde aber von Grund auf an Aiman Og born Instead of using their Code be built. Es ist a schneller, kleiner und wirklich nütparable Build: Deine eigene KI-Assistentin/der own Kürbelievers a recruiter of a recruiter for example can abfragen directly instead of relying on a Lebenslauf Parser.

Related MCP server: kazejev-personal

Was es bereitstellt

Sechs Tools:

• get_about() – Zusammenfassung, aktuelle Rolle, Ausbildung

• get_experience(role="") – Berufserfahrung, optional zusätzlich auf eine Rolle gefiltert

• get_projects(name="") – Projektbeschreibungen, optional gefiltert auf ein Projekt

• get_skills(category="") – Kennt, optional gesetzt nach einer Kategorie

• get_contact() – E-Mail, Website, LinkedIn, GitHub, Standort

• search_portfolio(query) – freie Suche über den gesamten Inhalt, für den Fall, dass der Aufrufer nicht weiß, welche das passend, welche is tools

Fünf Ressourcen, die rohen Markdown-Dateien, sind über URIs erreichbar (portfolio://about, portfolio://experience, portfolio://projects, portfolio://skills, portfolio://contact) – einen Client, der die gesamte Wissensbasis als Kontext im Voraus laden möchte, ohne die Tools einzeln zu Optionen.

Beides ist bewusst enthalten, nicht nur Tools: MCP unterscheidet wirklich between Tools (vom Modell ausgelöste Aktionen) und Ressourcen (passive, per URI addressierte Daten), and this server zeigt beides und nicht nur das, was die meisten Tutorials lungern.

Entscheidungen

Tools liefern gefilterten Text, kein strukturiertes JSON. get_experience("PookiDevs") gibt the passende Markdown section zurück, keine U.Parsed object with fields the named ones. In a Dafür ist a Wissensbasis dieser Größe (ein paarDateien, eine Person), a Model that is good written Markdown-Abschnitt liest, mindestens so meist nützlich wie read a parse JSON-SSC; and das means: Ein neue Erfahrung Positionin data/experience.mdset heißt nie, server.py berühren müssen.

**Suche arbeitet mit einem Wort – überlappung, keinemining ** embedding yes. search_portfolio counts the words in the query, and place in each division instead of vector index. Diese Server has none weiter dependencies outside itself the package mcp – no ChromaDB, no scikit, no. ein Modell nachladen; ung jeweils echt schnelles setup and at the scale problem (ein paar Zutaten köstliche kurze Bereits, nicht large corpus). If you would like to have the smarter search of next project, search_portfolio ist eine kleine Funktion, die sich is geholfen mit einem Aufruf in die as an, with link by ask-my-portfolio’s app/rag.py ersetzen l.

Delay handling are May portfolio/data/ images Not used. Both projects describe the same person; hence _data/. The about.md, experience, data and Resources examples here are copies of tar structures from in the development. This affinity about ask is wrong Japanese. contact.md is – as it is only needed in this server only. Hold it up sync with Wind if you update one or another, or symlink data/ between the two projects if to keep it between us.

Getestet

python test_server.py use to – in, create_connected_server_and_client_session – actual MCP protocol over In-memory-Streams (list_tools, call_tool, list_resources, read_token), exactly like a real Client, not just direct python has no. All 6 tools, and 5 resources holds all success including a filter that remains when empty; currently, the trained version shows a successful all 16 Checks, no setup, no Api Keys, with net data – therefore every area line locally Markdown.

Projektstruktur

server.py          FastMCP server: tools, resources, search
test_server.py      protocol-level integration test
data/
  about.md, experience.md, projects.md, skills.md, contact.md
requirements.txt, .gitignore

Ausführen

Hinzufügen an Claude Desktop and Claude Code in Serious you in SETUP.md. Hier der Kurz version:

pip install -r requirements.txt
python test_server.py     # prove it works, no client needed
python server.py          # starts the stdio MCP server