portfolio-mcp-server

An MCP (Model Context Protocol) server that connects AI tools — Claude Desktop, Cursor, GitHub Copilot — directly to your [universal-portfolio](https://github.com/muhammad-awais-web-dev/universal-portfolio) instance.

What it does

Exposes all 32 portfolio tools over stdio so any MCP-compatible AI client can:

• Read your profile, projects, skills, certifications, education, experience, and testimonials
• Create, update, and delete any portfolio item (with a write-enabled API key)

Related

• universal-portfolio — the full-stack portfolio app this server connects to: github.com/muhammad-awais-web-dev/universal-portfolio

Setup

1. Install dependencies

npm install

2. Configure environment

cp .env.example .env

Edit .env:

# URL of your running portfolio (local or deployed)
PORTFOLIO_URL=https://your-portfolio-domain.com

# API key from portfolio admin → Settings → API Keys
# Enable "can_write" on the key for write tool access
MCP_API_KEY=your_api_key_here

3. Test manually

npm start

For development with auto-reload:

npm run dev

The server communicates over stdio — it won't print anything until an MCP client connects. Startup messages appear on stderr.

Connect to Claude Desktop

Edit ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "portfolio": {
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. You'll see portfolio listed under MCP tools.

Connect to Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "portfolio": {
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Connect to VS Code

Requires VS Code 1.99+ with the GitHub Copilot extension.

Create or edit .vscode/mcp.json in your workspace (or add to your user settings.json under "mcp"):

{
  "servers": {
    "portfolio": {
      "type": "stdio",
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Open the Copilot Chat panel, switch to Agent mode, and the portfolio server will appear under available tools.

Connect to GitHub Copilot CLI

Edit ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "portfolio": {
      "type": "stdio",
      "command": "npx",
      "args": ["tsx", "/path/to/portfolio-mcp-server/src/index.ts"],
      "env": {
        "PORTFOLIO_URL": "https://your-portfolio-domain.com",
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools (32 total)

Read tools — any API key

Write tools — API key with can_write = true

Example prompts (once connected to Claude/Cursor/Copilot)

• "List all my projects"
• "What skills do I have in the Backend category?"
• "Update my profile bio to: I'm a full-stack developer..."
• "Create a new skill called Docker in the DevOps category"
• "Update project 5 — set body_html to: `<p>New description</p>`"
• "Publish project with slug 'my-app'"

Requirements

• Node.js 18+
• A running universal-portfolio instance
• An MCP API key (generated in the portfolio admin panel)