Portfolio MCP server

Portfolio MCP Server

An MCP server that turns my AI project portfolio into something you can query, not just read.

Point any MCP client (Claude Desktop, Cursor, custom agents) at it and ask "What has Ayush built with LangGraph?" or "What's his flagship project?" — it answers from live structured data, not a static PDF.

TL;DR

• 📦 Published, not just built — live on PyPI and the official MCP registry; pip install portfolio-mcp-server gets it running in any MCP client in under a minute, no repo clone required.
• 🔧 5 real tools — list, detail-lookup, stack search, flagship pick, and resume summary, all backed by structured data instead of a static README scroll.
• ✅ CI-tested on every push — lint, type-check, and a real stdio smoke test that calls all 5 tools and validates the JSON schema of each response.

Table of contents

• Why this exists
• Demo
• Tools exposed
• Quickstart
• Connect to Claude Desktop
• Stack
• Testing & CI
• Project structure
• Roadmap
• License
• Author

Why this exists

Most AI-developer portfolios are a list of links. This is a working MCP server — the same protocol agentic products use to connect to tools — built around my own portfolio. It's both a real implementation of the spec and an answer to "show me you've actually built with MCP," not just talked about it.

Demo

🎥 Full video walkthrough

https://github.com/user-attachments/assets/4c1b844a-087f-48a6-b156-bdef27282acc

Setup → tool calls → live answers, end to end.

Tools exposed

Quickstart

Option A — install from PyPI (fastest):

pip install portfolio-mcp-server

Option B — clone and run from source (for local edits/testing):

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.txt

Test it interactively with the MCP Inspector before wiring it into a client:

mcp dev server.py

This opens a browser UI where you can call each tool manually and inspect raw request/response payloads.

Connect to Claude Desktop

Open your Claude Desktop config file:

Shortened. The full README is on GitHub.