Skip to main content
Glama
akin-portfolio-mcp

akin-portfolio-mcp

by akincskn

akin-portfolio-mcp

npm version License: MIT Node.js TypeScript MCP

An MCP (Model Context Protocol) server that lets AI assistants — Claude Desktop, Claude Code, Cursor, and others — query information about Akın Coşkun's developer portfolio: projects, skills, and contact details. No API keys, no deployment — just npx and go.


Tools

Tool

Description

get_about

General info: name, title, location, summary

get_skills

Full tech stack, optionally filtered by category

get_projects

All projects with descriptions and links

get_project_detail

Deep-dive into a specific project by name

search_projects

Search projects by keyword (tech, feature, etc.)

get_contact

Email, GitHub, LinkedIn, portfolio URL

get_experience_summary

Quick stats: project count, key areas

Related MCP server: Developer Portfolio MCP Server

Resources

URI

Description

portfolio://about

About data as JSON

portfolio://skills

Skills data as JSON

portfolio://projects

Projects data as JSON


Installation

Option 1 — npx (no install needed)

npx akin-portfolio-mcp

Option 2 — Global install

npm install -g akin-portfolio-mcp
akin-portfolio-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "akin-portfolio": {
      "command": "npx",
      "args": ["-y", "akin-portfolio-mcp"]
    }
  }
}

Config file locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json


Claude Code / Cursor Configuration

Add to your MCP settings (.claude/settings.json or ~/.cursor/mcp.json):

{
  "mcpServers": {
    "akin-portfolio": {
      "command": "npx",
      "args": ["-y", "akin-portfolio-mcp"]
    }
  }
}

Example Questions

Once configured, ask your AI assistant:

  • "What are Akın's projects?"

  • "Does Akın know N8N?"

  • "What's Akın's most complex project?"

  • "Show me Akın's AI-related projects."

  • "What databases does Akın work with?"

  • "Give me Akın's contact info."

  • "How many production apps has Akın built?"


Testing with MCP Inspector

npx @modelcontextprotocol/inspector npx akin-portfolio-mcp

This opens an interactive UI to call each tool and inspect responses.


Tech Stack

Built with:

  • MCP SDK — official TypeScript SDK

  • Zod — runtime input validation

  • TypeScript (strict mode)

  • Node.js 18+, stdio transport


License

MIT © Akın Coşkun

Available Tools

7 tools
get_aboutA

Get general information about Akın Coşkun: name, title, location, and professional summary.

Inputs: no named parameters.

get_contactA

Get Akın's contact information: email, GitHub, and portfolio URL.

Inputs: no named parameters.

get_experience_summaryA

Get a brief summary of Akın's experience: total projects, production apps, and key technology areas.

Inputs: no named parameters.

get_project_detailA

Get detailed information about a specific project by name.

Inputs: name (required).

get_projectsA

List all of Akın's projects with descriptions, tech stacks, and links.

Inputs: no named parameters.

get_skillsA

Get Akın's technology stack. Optionally filter by category: frontend, backend, database, auth, automation, ai, devops, tools.

Inputs: category.

search_projectsA

Search projects by keyword. Matches against project name, description, tech stack, and highlights.

Inputs: keyword (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: about, skills, projects list, project detail, project search, contact, and experience summary. No two tools overlap in functionality.

    Naming Consistency5/5

    All tools follow the verb_noun pattern consistently: get_about, get_skills, get_projects, get_project_detail, search_projects, get_contact, get_experience_summary. The minor variation 'search_projects' still adheres to the pattern.

    Tool Count5/5

    With 7 tools, the server is well-scoped for a portfolio. Each tool is necessary and sufficient to cover the key aspects of the portfolio without redundancy.

    Completeness5/5

    The tool set covers all essential portfolio information: personal intro, skills (with filtering), projects (list, detail, search), contact, and experience summary. No obvious gaps for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that provides a structured API for AI agents to query a person's resume, including profile, projects, writing, and gated access to experience and skills.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server that provides Thomas Klaushofer's professional profile including career history, skills, projects, and achievements, allowing AI assistants to answer questions about his background.
      59 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server that exposes an AI project portfolio as queryable tools, allowing users to ask about projects, search by technology, or get details via natural language.
      5
      63 PyPI
      1
      MIT