# 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**:
   ```bash
   npm install
   ```

2. **Build the project**:
   ```bash
   npm run build
   ```

3. **Configure Claude Desktop** by adding this to your `claude_desktop_config.json`:
   ```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](https://modelcontextprotocol.io/)
- Review the [TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
- Create an issue in this repository