portfolio-mcp

portfolio-mcp

Enables AI assistants to query the author's career, projects, publications, and technical documents through read-only MCP tools.

Category
Visit Server

README

portfolio-mcp

내 포트폴리오를 MCP(Model Context Protocol) 서버로 만들었다. Claude Desktop이나 Claude Code에 붙이면 AI가 내 경력, 프로젝트, 논문을 도구로 직접 조회한다. "이 사람 TTFB 최적화 어떻게 했어?" 같은 질문이 가능해진다.

demo

데모는 demo_session.py로 실행한 실제 세션 출력을 그대로 옮긴 것이다.

구성

MCP Client (Claude 등)
   │  stdio
   ▼
portfolio_mcp ── BM25 검색 ─── data/docs/*.md      기술문서 5편
   └─────────── 구조화 조회 ── data/profile.json   경력 사실
도구 하는 일
portfolio_get_profile 경력 회사·기간·직급, 학력, 기술 스택, 링크
portfolio_list_projects 프로젝트 11개 목록. 회사명 필터 지원
portfolio_get_publications 논문 7편(제1저자), 특허 2건(제1발명자), 수상
portfolio_search 기술문서 BM25 검색. 트러블슈팅 과정 같은 세부 내용용

전부 read-only다.

설계하면서 정한 것들

  • 의존성은 mcp SDK와 rank_bm25 둘뿐이다. 처음엔 임베딩 검색도 고려했는데 문서 5편에 청크 80개 규모에서 벡터 검색은 과하다. BM25면 충분하고, 덕분에 GPU도 외부 API도 없이 clone 후 바로 돈다.
  • 추론은 클라이언트 LLM의 몫이다. 서버는 데이터만 정확하게 내려주면 된다.
  • 확정된 사실(경력, 논문, 수치)은 profile.json으로, 서술형 내용은 문서 검색으로 분리했다. 숫자가 검색 랭킹에 따라 흔들리면 안 되기 때문이다.
  • 검색 결과가 비면 "다른 키워드로 재검색하거나 목록부터 보라"는 힌트를 응답에 같이 넣는다. 에러 메시지가 다음 행동을 알려줘야 agent가 헤매지 않는다.

실행

python -m venv .venv && .venv\Scripts\activate
pip install -r requirements.txt

python test_client.py   # 서버 기동 + 도구 4개 호출 스모크 테스트

Claude에 연결

Claude Code:

claude mcp add portfolio /path/to/.venv/Scripts/python.exe /path/to/portfolio-mcp/server.py

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "portfolio": {
      "command": "C:/path/to/portfolio-mcp/.venv/Scripts/python.exe",
      "args": ["C:/path/to/portfolio-mcp/server.py"]
    }
  }
}

연결하고 이런 걸 물어보면 된다.

  • 이윤선의 TTS 프로젝트에서 스트리밍 팝 노이즈를 어떻게 해결했는지 찾아줘
  • 인피닉에서 한 프로젝트 목록 보여줘
  • 특허 등록번호 알려줘

Python / MCP SDK (FastMCP) / rank_bm25 / stdio

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured