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

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:

{
  "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):

{
  "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:

npm run build

For development with auto-rebuild on changes:

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