🔌 Bijon Portfolio MCP Server

A Node.js & TypeScript-based Model Context Protocol (MCP) server that exposes my resume, portfolio projects, certifications, skills, and live GitHub repositories as tools. This allows AI assistants (like Claude Desktop) to query my professional background, projects, and experiences dynamically using natural language.

---

🚀 Features & Exposed Tools

The server registers the following tools with the MCP client:

1. getProfile: Exposes core bio, contact information, education history, work/internship experiences, volunteering, and social links.
2. getProjects: Lists curated portfolio projects (both professional and academic), with support for filtering by specific tech stacks (e.g. React, Laravel, Node.js).
3. getSkills: Lists structured technical skills categorized by programming languages, frameworks, and developer tools.
4. getCertificates: Lists professional and academic certifications (e.g., Salesforce AI Associate, Postman Expert, etc.).
5. getGithubRepos: Performs an authenticated fetch to the GitHub API to return a live list of my active public repositories, showing updated dates, stars, and languages.
6. askAboutBijon: A free-text search tool allowing natural language Q&A across the entire portfolio dataset (e.g., "What did he do at FAITE?" or "Summarize his research project at SLIIT").

---

🛠️ Tech Stack

• Runtime: Node.js (v18+)
• Language: TypeScript
• Protocol: @modelcontextprotocol/sdk (Stdio transport)
• JSON Data Layer: Custom file-based single source of truth for resume info.

---

📦 Getting Started

Prerequisites

• Node.js installed (LTS recommended)
• A GitHub Personal Access Token (GITHUB_TOKEN) with read-only public repository access (recommended to avoid API rate limits).

Setup

1. Clone the repository:

   git clone https://github.com/Bijon2002/Build-Own-MCP.git
   cd Build-Own-MCP
   

2. Install dependencies:

   npm install
   

3. Configure Environment Variables: Create a .env file in the root directory (or copy from the template):

   GITHUB_TOKEN=your_github_personal_access_token_here
   

4. Build the project:

   npm run build
   

---

🖥️ Local Integration (Claude Desktop)

To add this server to your local Claude Desktop client, edit the configuration file:

1. Open your Claude Desktop config file:

   • On Windows: %APPDATA%\Claude\claude_desktop_config.json
   • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the following definition under the mcpServers property:

{
  "mcpServers": {
    "bijon-portfolio": {
      "command": "npx",
      "args": [
        "-y",
        "tsx",
        "A:/Build Own MCP/src/server.ts"
      ],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

3. Restart Claude Desktop. You will now see the tool icon (🔌) with my portfolio tools active!

---

📂 Project Structure

├── data/
│   ├── portfolio-data.json   # Bio, education, experience, skills, socials
│   ├── projects.json         # Curated projects list
│   └── certificates.json     # Certifications list
├── src/
│   ├── lib/
│   │   ├── github.ts         # Live GitHub API query helper
│   │   └── loadData.ts       # JSON loader helper
│   ├── tools/
│   │   ├── askAboutBijon.ts  # Free-text Q&A tool
│   │   ├── getCertificates.ts
│   │   ├── getGithubRepos.ts
│   │   ├── getProfile.ts
│   │   ├── getProjects.ts
│   │   └── getSkills.ts
│   └── server.ts             # Entry point (MCP server & stdio setup)
├── tsconfig.json
├── package.json
└── README.md

---

👨‍💻 Author

Marislin Bijosilin (Bijon)

• Website: bijon.dev
• GitHub: @Bijon2002
• LinkedIn: in/marisilin-bijosilin