# Senior Developer Job Description MCP Server

An MCP (Model Context Protocol) server that helps you write compelling job descriptions for senior developers. This server provides hiring guidelines, a comprehensive discovery checklist, and an AI-powered prompt to refine your job descriptions.

## What This MCP Provides

### Resources

1. **Senior Developer Hiring Guide** (`hiring-guide://senior-developer`)
   - Best practices for attracting and hiring senior developers
   - Five key principles: Define, Match Channel, Pitch, Vet, Close
   - Insights on what senior developers care about

2. **Recruiting Discovery Checklist** (`checklist://recruiting-discovery`)
   - Comprehensive checklist covering all aspects of a position
   - Topics: Business, Team, Requirements, Roadmap, Salary & Benefits
   - Ensures you can answer all candidate questions

### Prompts

1. **Refine Job Description** (`refine-job-description`)
   - Reviews your job description against best practices
   - Identifies missing information
   - Generates clarifying questions to create a complete profile
   - **Argument**: `job_info` - Your current job description or position info

## Installation & Setup

### Prerequisites

- Node.js (v18 or higher)
- npm

### Build the Server

```bash
npm install
npm run build
```

This will compile the TypeScript code to the `build/` directory.

## Usage with Claude Desktop (Claude Code)

To use this MCP server with Claude Desktop or Claude Code, add it to your MCP settings configuration:

### For Claude Desktop

Edit your Claude Desktop config file:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%/Claude/claude_desktop_config.json`

Add the following to the `mcpServers` section:

```json
{
  "mcpServers": {
    "senior-dev-job-description": {
      "command": "node",
      "args": ["/absolute/path/to/mcptest/build/index.js"]
    }
  }
}
```

Replace `/absolute/path/to/mcptest` with the actual path to this project.

### For Claude Code CLI

Add to your Claude Code MCP settings file (`~/.config/claude/mcp_settings.json`):

```json
{
  "mcpServers": {
    "senior-dev-job-description": {
      "command": "node",
      "args": ["/absolute/path/to/mcptest/build/index.js"]
    }
  }
}
```

### For Manus

Follow Manus documentation for adding MCP servers, using the same command structure:
- **Command**: `node`
- **Args**: `["/absolute/path/to/mcptest/build/index.js"]`

## How to Use

Once configured, you can interact with this MCP server in your Claude conversations:

### Accessing Resources

Ask Claude to read the resources:
- "Show me the senior developer hiring guide"
- "What's in the recruiting discovery checklist?"

### Using the Refine Prompt

Use the prompt to improve your job description:
```
Use the refine-job-description prompt with this information:
[paste your current job description]
```

Claude will analyze your job description and ask targeted questions to fill in gaps.

## Development

### Project Structure

```
.
├── src/
│   └── index.ts          # MCP server implementation
├── resources/
│   ├── hiring-guide.md   # Hiring best practices
│   └── recruiting-discovery-checklist.md
├── prompts/
│   └── refine-job-description.md
├── build/                # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md
```

### Making Changes

After modifying the TypeScript code:

```bash
npm run build
```

For development with auto-rebuild on changes:

```bash
npm run watch
```

### Testing the Server

You can test the MCP server using the MCP Inspector or by integrating it with Claude Desktop/Code and checking the logs.

## Contributing

This is a personal project for learning MCP server development. Feel free to fork and adapt for your own use.

## License

MIT