Portfolio MCP Server
Portfolio MCP Server
私のAIプロジェクトポートフォリオを、読むだけでなく検索できるものに変えるMCPサーバー。
あらゆるMCPクライアント(Claude Desktop、Cursor、カスタムエージェント)を接続して、 「AyushはLangGraphで何を構築した?」 や 「彼の代表的なプロジェクトは?」 と尋ねると、 — 静的PDFではなく、ライブな構造化データから回答します。
TL;DR
📦 公開済み、作っただけではない — PyPIと公式MCPレジストリで公開中。
pip install portfolio-mcp-serverを実行すれば、リポジトリのクローン不要で1分以内に任意のMCPクライアントで動作します。🔧 実際に動く5つのツール — 一覧表示、詳細検索、スタック検索、フラッグシップ選択、レジュメ要約。すべて静的READMEのスクロールではなく構造化データに基づいています。
✅ すべてのプッシュでCIテスト済み — lint、型チェック、そして5つのツールすべてを呼び出して各レスポンスのJSONスキーマを検証する実際のstdioスモークテストを実行。
目次
Related MCP server: toad-mcp-server
存在理由
ほとんどのAI開発者ポートフォリオはリンクの羅列にすぎません。これは、エージェント型プロダクトがツールに接続するために使うのと同じプロトコルであるMCPサーバーを、自分のポートフォリオを中心に構築したものです。仕様の実際の実装であると同時に、「MCPで実際に何かを作ったことを見せて」 という問いへの答えでもあります。ただ話すだけではなく。
デモ
MCP Inspector — ツール探索 | ライブチャットデモ |
|
|
https://github.com/user-attachments/assets/4c1b844a-087f-48a6-b156-bdef27282acc
セットアップ → ツール呼び出し → ライブ回答まで、エンドツーエンドで。
公開ツール
ツール | 説明 |
| 全9プロジェクトの短い概要 |
| 1つのプロジェクトの完全な詳細 |
| 指定したテクノロジーを使用しているプロジェクトを検索 |
| 最初に見るべき最高のプロジェクト |
| 経歴、目標とする役割、コアスタック |
クイックスタート
オプションA — PyPIからインストール(最速):
pip install portfolio-mcp-serverオプションB — ソースからクローンして実行(ローカルでの編集・テスト用):
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クライアントに組み込む前に、MCP Inspectorで対話的にテストできます:
mcp dev server.pyブラウザUIが開き、各ツールを手動で呼び出して、生のリクエスト/レスポンスペイロードを検査できます。
Claude Desktopへの接続
Claude Desktopの設定ファイルを開きます:
OS | パス |
macOS |
|
Windows |
|
ファイルに他のサーバーが含まれる mcpServers キーがすでにある場合は、ファイルを上書きせず、既存のオブジェクト内に "portfolio" エントリを追加してください。
PyPIからインストールした場合(上記のオプションA):
{
"mcpServers": {
"portfolio": {
"command": "portfolio-mcp-server"
}
}
}クローンしたソースチェックアウトから実行している場合(上記のオプションB): お使いのマシン上の server.py への絶対パスを使用します:
{
"mcpServers": {
"portfolio": {
"command": "python",
"args": ["/absolute/path/to/portfolio-mcp-server/server.py"]
}
}
}Claude Desktopを再起動し、次のように尋ねてみてください:
「AyushはFastAPIでどのようなプロジェクトを構築しましたか?」
Claudeは search_projects_by_stack を呼び出し、ライブデータから回答します。
技術スタック
Python 3.10+
MCP Python SDK (
FastMCP)stdioトランスポート
PyPI用にパッケージ化され、公式のMCPサーバーレジストリに登録済み(
io.github.ayush-s-tomar/portfolio-mcp-server)
テストとCI
すべてのプッシュとプルリクエストはGitHub Actionsで実行されます:
Lint —
ruff check .型チェック —
mypy server.pyスモークテスト — サーバーを起動し、stdio経由で5つのツールをそれぞれ呼び出して、有効でスキーマに一致するJSONを返すことを確認します
.github/workflows/ci.yml を参照してください。PRを開く前に、同じチェックをローカルで実行します:
pip install -r requirements-dev.txt
ruff check .
mypy server.py
pytestプロジェクト構成
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
ロードマップ
インストール可能なパッケージとしてPyPIに公開
公式MCPサーバーレジストリに公開
search_projects_by_stack— 複数のテクノロジーを同時にマッチングできるようにするリモートクライアント向けにstdioに加えてHTTP/SSEトランスポートオプションを追加
静的JSONの代わりに軽量なリフレッシュエンドポイントでレジュメ/プロジェクトデータをキャッシュ
ライセンス
MIT License の下で公開されています。
作者
Ayush Tomar — GitHub
独自のMCPサーバーを構築する際の参考として役立ったなら、リポジトリへの⭐をお願いします。
mcp-name: io.github.ayush-s-tomar/portfolio-mcp-server
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.-

