MdMizanurVU/professional-twin-mcp

Professional Twin MCP Server

A Model Context Protocol (MCP) server that provides Claude Desktop with access to professional digital twin data including experience, skills, projects, achievements, and availability information.

Features

🔧 Tools

• search_professional_data: Semantic search across all professional information
• get_contact_info: Access contact details and availability status
• schedule_collaboration: Help schedule meetings and collaborations
• explain_experience: Get detailed explanations of work experience and projects

📚 Resources

• profile: Complete professional profile in JSON format
• skills-matrix: Skills matrix with proficiency levels
• portfolio: Project portfolio with detailed information

💬 Prompts

• introduction: Generate context-appropriate professional introductions
• project-showcase: Create project showcase presentations for different audiences

Installation

1. Install dependencies:

   npm install
   

2. Build the project:

   npm run build
   

3. Configure Claude Desktop by adding this to your claude_desktop_config.json:

   {
     "mcpServers": {
       "professional-twin": {
         "command": "node",
         "args": ["/absolute/path/to/professional-twin-mcp/build/index.js"]
       }
     }
   }
   

   Note: Replace /absolute/path/to/professional-twin-mcp/ with the actual absolute path to this project directory.

Configuration File Locations

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

Usage Examples

Search Professional Data

Search for "React" experience

Claude will use the search_professional_data tool to find all React-related experience, skills, and projects.

Get Contact Information

What are your contact details and availability?

Claude will use the get_contact_info tool to provide contact information and current availability.

Schedule a Meeting

I'd like to schedule a 1-hour technical consultation about React development

Claude will use the schedule_collaboration tool to help coordinate the meeting.

Project Details

Tell me more about the e-commerce platform project, focusing on technical aspects

Claude will use the explain_experience tool to provide detailed technical information.

Professional Introductions

Generate a formal introduction for an executive meeting

Claude will use the introduction prompt to create an appropriate introduction.

Data Structure

The server contains comprehensive professional data including:

• Personal Information: Name, title, professional summary
• Work Experience: Companies, roles, achievements, technologies used
• Skills: Technical skills with proficiency levels and experience years
• Projects: Detailed project information with outcomes and links
• Achievements: Certifications, awards, speaking engagements
• Availability: Current status, working hours, preferred contact methods
• Contact Information: Email, phone, social profiles, location

Development

Available Scripts

• npm run build - Compile TypeScript to JavaScript
• npm run dev - Watch mode for development
• npm start - Run the built server
• npm run clean - Remove build directory

Testing

To test the server locally:

1. Build the project: npm run build
2. Run directly: node build/index.js
3. The server will start and wait for MCP protocol messages on stdin

Customization

To customize the professional data:

1. Edit the professionalProfile object in src/index.ts
2. Rebuild the project: npm run build
3. Restart Claude Desktop to pick up changes

Architecture

This MCP server follows the Model Context Protocol specification and provides:

• STDIO Transport: Communicates with Claude Desktop via standard input/output
• Type Safety: Full TypeScript implementation with proper type definitions
• Modular Design: Separated interfaces and data structures for easy maintenance
• Error Handling: Proper error responses for invalid requests

Requirements

• Node.js 18.0.0 or higher
• TypeScript 5.3.0 or higher
• Claude Desktop with MCP support

License

MIT License - feel free to use and modify for your own professional digital twin.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test with Claude Desktop
5. Submit a pull request

Support

For issues and questions:

• Check the MCP Documentation
• Review the TypeScript SDK
• Create an issue in this repository