Generate topic-specific jokes:

Prompt: generate-dad-joke
Topic: "TypeScript"
Style: "punny"

Rate team jokes:

Prompt: rate-dad-joke
Joke: "Why do developers wear glasses? Because they can't C#!"

Browse categories for inspiration:

Tool: get-joke-categories

Integration Ideas

Code Review Comments: Add dad jokes to lighten PR reviews
Team Standup: Start meetings with a daily dad joke
Error Messages: Soften build failures with humor
Documentation: Add personality to technical docs
Slack Bots: Integrate with team communication tools

🧪 Testing

The project includes a basic test structure:

# Run tests (implement tests in tests/ directory)
npm test

# Run tests in watch mode
npm test -- --watch

# Run tests with coverage
npm test -- --coverage

Manual Testing

Test the server manually:

# Build and start
npm run build && npm start

# In another terminal, test with sample MCP client
echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}}' | node dist/index.js

🔧 Configuration

Environment Variables

# Optional: Enable debug logging
DEBUG=true

# Optional: Set custom logging level
LOG_LEVEL=info

Customization

Modify the joke categories, styles, or statistics by editing the arrays in src/index.ts:

// Add new categories
const categories = [
  "Animals", "Food", "Technology", // ... existing
  "Your Custom Category"
];

// Add new joke styles
const styles = ["classic", "punny", "wholesome", "groan-worthy", "your-style"];

📦 Publishing

To publish to npm:

# Ensure you're logged into npm
npm login

# Build and prepare for publishing
npm run prepublishOnly

# Publish (update version in package.json first)
npm version patch  # or minor/major
npm publish

🤝 Contributing

We welcome contributions! Here's how to get started:

Quick Start for Contributors

Fork the repository on GitHub

Clone your fork:

git clone https://github.com/YOUR-USERNAME/dad-jokes-mcp-server.git
cd dad-jokes-mcp-server

Create a feature branch:

git checkout -b feature/amazing-feature

Make your changes and test them
Commit your changes:
```
git commit -m "Add amazing feature"
```

Push to your branch:

git push origin feature/amazing-feature

Open a Pull Request on GitHub

Development Guidelines

Follow TypeScript best practices
Add tests for new features
Update documentation for API changes
Run npm run lint before committing
Keep jokes family-friendly and inclusive

Ideas for Contributions

🎭 New joke categories (Science, Gaming, etc.)
🛠️ Additional tools (joke history, favor

Categories

Current Category: dad-jokes

dad-jokes-mcp-server