Portfolio MCP Server
Portfolio MCP Server
Ein MCP-Server, der mein KI-Projektportfolio in etwas verwandelt, das man abfragen kann – nicht nur lesen.
Richte einen beliebigen MCP-Client (Claude Desktop, Cursor, eigene Agents) darauf und frage „Was hat Ayush mit LangGraph gebaut?" oder „Was ist sein Flaggschiff-Projekt?" — er antwortet aus strukturierten Live-Daten, nicht aus einem statischen PDF.
TL;DR
📦 Veröffentlicht, nicht nur gebaut — live auf PyPI und im offiziellen MCP-Registry;
pip install portfolio-mcp-serverbringt es in unter einer Minute in jedem MCP-Client zum Laufen, ohne Repo-Klon.🔧 5 echte Tools — Liste, Detailabfrage, Stack-Suche, Flaggschiff-Auswahl und Lebenslauf-Zusammenfassung, alle basierend auf strukturierten Daten statt eines statischen README-Scrolls.
✅ Bei jedem Push CI-getestet — Lint, Typprüfung und ein echter stdio-Smoke-Test, der alle 5 Tools aufruft und das JSON-Schema jeder Antwort validiert.
Inhaltsverzeichnis
Related MCP server: toad-mcp-server
Warum es das gibt
Die meisten KI-Entwickler-Portfolios sind eine Liste von Links. Das hier ist ein funktionierender MCP-Server — dasselbe Protokoll, das agentische Produkte zur Anbindung von Tools verwenden — rund um mein eigenes Portfolio gebaut. Es ist sowohl eine echte Implementierung der Spezifikation als auch eine Antwort auf „Zeig mir, dass du wirklich mit MCP gebaut hast", nicht nur darüber geredet.
Demo
MCP Inspector — Tool-Erkennung | Live-Chat-Demo |
|
|
https://github.com/user-attachments/assets/4c1b844a-087f-48a6-b156-bdef27282acc
Setup → Tool-Aufrufe → Live-Antworten, Ende zu Ende.
Bereitgestellte Tools
Tool | Beschreibung |
| Kurzzusammenfassung aller 9 Projekte |
| Vollständige Details für ein Projekt |
| Findet Projekte, die eine bestimmte Technologie verwenden |
| Das beste Projekt für den Einstieg |
| Hintergrund, Zielrolle und Kern-Stack |
Schnellstart
Option A — von PyPI installieren (am schnellsten):
pip install portfolio-mcp-serverOption B — Klonen und aus dem Quellcode ausführen (für lokale Änderungen/Tests):
git clone https://github.com/ayush-s-tomar/portfolio-mcp-server.git
cd portfolio-mcp-server
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txtTeste es interaktiv mit dem MCP Inspector, bevor du es in einen Client einbindest:
mcp dev server.pyDies öffnet eine Browser-Oberfläche, in der du jedes Tool manuell aufrufen und die rohen Request/Response-Payloads inspizieren kannst.
Mit Claude Desktop verbinden
Öffne die Konfigurationsdatei von Claude Desktop:
Betriebssystem | Pfad |
macOS |
|
Windows |
|
Wenn die Datei bereits einen mcpServers-Schlüssel mit anderen Servern enthält,
füge den Eintrag "portfolio" innerhalb des vorhandenen Objekts hinzu, anstatt
die Datei zu überschreiben.
Wenn du über PyPI installiert hast (Option A oben):
{
"mcpServers": {
"portfolio": {
"command": "portfolio-mcp-server"
}
}
}Wenn du aus einem geklonten Quellcode-Checkout ausführst (Option B oben): verwende den absoluten Pfad zu server.py auf deinem Rechner:
{
"mcpServers": {
"portfolio": {
"command": "python",
"args": ["/absolute/path/to/portfolio-mcp-server/server.py"]
}
}
}Starte Claude Desktop neu und frage dann zum Beispiel:
„Welche Projekte hat Ayush mit FastAPI gebaut?"
Claude wird search_projects_by_stack aufrufen und aus den Live-Daten antworten.
Stack
Python 3.10+
MCP Python SDK (
FastMCP)stdio-Transport
Für PyPI verpackt und im offiziellen MCP-Server-Registry registriert (
io.github.ayush-s-tomar/portfolio-mcp-server)
Tests & CI
Jeder Push und Pull Request durchläuft GitHub Actions:
Lint —
ruff check .Typprüfung —
mypy server.pySmoke-Test — startet den Server und ruft jedes der 5 Tools über stdio auf, um zu bestätigen, dass sie gültiges, schema-konformes JSON zurückgeben
Siehe .github/workflows/ci.yml. Führe dieselben
Prüfungen lokal aus, bevor du einen PR eröffnest:
pip install -r requirements-dev.txt
ruff check .
mypy server.py
pytestProjektstruktur
portfolio-mcp-server/ ├── server.py # FastMCP server + tool definitions ├── data/ │ └── projects.json # Project data the tools read from ├── tests/ │ └── test_tools.py # Smoke tests for each tool ├── requirements.txt ├── requirements-dev.txt ├── pyproject.toml # PyPI packaging config ├── server.json # MCP registry manifest └── .github/workflows/ci.yml
Roadmap
Als installierbares Paket auf PyPI veröffentlichen
Im offiziellen MCP-Server-Registry veröffentlichen
search_projects_by_stack— Unterstützung für die gleichzeitige Suche nach mehreren TechnologienEine HTTP/SSE-Transportoption neben stdio für entfernte Clients hinzufügen
Lebenslauf-/Projektdaten mit einem leichten Aktualisierungs-Endpunkt statt statischem JSON cachen
Lizenz
Veröffentlicht unter der MIT-Lizenz.
Autor
Ayush Tomar — GitHub
Wenn das als Referenz für den Bau deines eigenen MCP-Servers nützlich war, ist
Available Tools
7 toolsget_data_infoARead-onlyIdempotent
Say how current the portfolio data is: its date, whether it came from the live repository or the copy bundled with the installed package, how many projects it holds, and the package version.
Inputs: no named parameters. Returns: object
get_flagship_projectARead-onlyIdempotent
Get Ayush's flagship project, the one to look at first for a quick sense of his skill level.
Inputs: no named parameters. Returns: object
get_project_detailsARead-onlyIdempotent
Get full details for one project by name.
Matching is case-insensitive: an exact name wins, then a name prefix, then any part of a name ('sales' finds SalesAgent), then the words in a description ('RAG chatbot' finds AskMyDocs). If several projects match, the best one is returned and the others are listed under 'also_matches'.
Returns description, full stack, GitHub repo, live demo link, and writeup link if one exists.
Inputs: project_name (required). Returns: object
get_resume_summaryARead-onlyIdempotent
Get a summary of Ayush's background: education, target role, core tech stack, and career highlights.
Inputs: no named parameters. Returns: object
list_projectsARead-onlyIdempotent
List all projects in Ayush's portfolio with a short summary of each.
Returns a compact list (name, short description, stack). Use get_project_details for the full description, GitHub link, and demo URL.
Inputs: no named parameters. Returns: result
match_job_descriptionARead-onlyIdempotent
Rank Ayush's projects against a pasted job description.
Finds the technologies and topics in the text (LangGraph, FastAPI, RAG, agents, ...) and scores each project by how many it covers. This is a keyword overlap, a quick way to see which projects to open first. It is not an assessment of fit.
Inputs: job_description (required), top_n. Returns: object
search_projects_by_stackARead-onlyIdempotent
Find projects that use one or more technologies or topics.
Case-insensitive, partial names match ('lang' finds LangGraph). Separate several with commas, '+', '&' or 'and' to require all of them, e.g. 'LangGraph and FastAPI'. Common topics are understood too: 'RAG', 'agents', 'voice', 'fine-tuning', 'frontend', 'backend'.
Useful for answering "does Ayush have experience with X?"
Inputs: technology (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct need: listing, single-project detail, stack filtering, JD matching, flagship shortcut, resume summary, and data provenance. Descriptions explicitly cross-reference each other (list_projects points to get_project_details) and clarify boundaries. get_flagship_project slightly overlaps with get_project_details but has a clearly different presentation purpose.
All names are snake_case with a verb-first pattern (list_, get_, search_, match_) followed by a clear resource or concept. The two non-'get' verbs (search_projects_by_stack, match_job_description) still follow verb_object convention and read predictably.
Seven tools is well-scoped for a personal portfolio server — every tool maps to a real question a recruiter or agent would ask. Nothing feels redundant or padded.
The read-only surface covers browsing, detail, tech search, JD matching, resume, and data freshness with no dead ends. Minor gaps: no way to retrieve contact/social links or enumerate all technologies directly, though get_resume_summary and search partially cover this.
Maintenance
Related MCP Connectors
MCP server for generating rough-draft project plans from natural-language prompts.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that lets recruiters and AI assistants explore your profile, skills, and projects through natural language.6MIT
- AlicenseAqualityDmaintenanceMCP server exposing portfolio AI tools including semantic search, evaluation framework, and prompt management, enabling natural language interaction with these services via Claude Desktop.5ISC
- FlicenseNot gradedqualityDmaintenanceAn MCP server for controlling the TimeLiner project management system, enabling AI clients to manage projects, tasks, members, and more via natural language.-
- FlicenseNot gradedqualityCmaintenanceAn MCP server that enables AI assistants to interact with OpenProject, listing projects and work packages and managing resources through natural language.-

