What is Mcp Traits Matcher

mcp-traits-matcher is a personality analysis server built using the FastMCP framework. It manages individuals and their traits in SQLite databases, allowing for personality updates based on descriptions.

Use cases

Use cases include creating profiles for job candidates, matching candidates to specific job descriptions, and conducting personality assessments for team dynamics.

How to use

To use mcp-traits-matcher, clone the repository, set up a virtual environment, install dependencies, and run the server. You can create persons and traits, add descriptions, and find candidates matching job descriptions using provided API methods.

Key features

Key features include the ability to create persons and traits, update personalities based on descriptions, find candidates that match job descriptions using Euclidean distance, and list all persons and traits.

Where to use

mcp-traits-matcher can be used in various fields such as human resources for recruitment, personality research, and any application requiring personality matching based on traits.

MCP Traits Matcher

Description

A personality analysis server built using the FastMCP framework. It provides tools and resources for personality analysis and matching.

Features

• Creates persons and traits.
• Adds descriptions to persons, updating their personality based on traits.
• Finds people matching a company’s job description.
• Exposes resources for listing persons and traits.

Setup Instructions

Prerequisites

• Python 3.x
• pip

Installation

1. Clone the repository.
2. Create a virtual environment: python -m venv venv
3. Activate the virtual environment:
   • Windows: venv\Scripts\activate
   • Linux/macOS: source venv/bin/activate
4. Install dependencies: pip install --user -r requirements.txt

Database Setup

The server uses SQLite databases (mcp_persons.db and mcp_traits.db). These databases will be created automatically when the server is run.

Usage Examples

Creating a person

mcp.create_person(name="John Doe")

Adding a description to a person

mcp.add_description(name="John Doe", description="friendly and dominant")

Creating a trait

mcp.create_trait(name="friendly", friendliness=8.0, dominance=2.0)

Finding matches for a job description

mcp.find_matches(company_name="Acme Corp", job_description="Looking for friendly and dominant candidates")

API Documentation

Resources

• persons://all: Lists all persons.
• traits://all: Lists all traits.
• persons://{name}: Gets a person by their name.

Tools

• create_person: Creates a new person.
• add_description: Adds a description to a person.
• create_trait: Creates a new trait.
• find_matches: Finds people matching a job description.

Dependencies

• scipy
• pydantic>=2.7.2,<3.0.0
• fastmcp

License

MIT-0 License