Traits Matcher

🚀 MCP Personality Matcher

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

🚀 Quick Start

The MCP Personality Matcher is a server designed for personality analysis and matching. It provides a range of tools to create, manage, and analyze personalities.

✨ Features

• Create persons and traits.
• Add descriptions to persons and update their personalities based on traits.
• Find individuals who match a company's job description.
• Provide resources to list persons and traits.

📦 Installation

Prerequisites

• Python 3.x
• pip

Installation Steps

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

🔧 Technical Details

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

💻 Usage Examples

Basic Usage

Create a Person

mcp.create_person(name="John Doe")

Add a Description to a Person

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

Create a Trait

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

Find Matches for a Job Description

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

📚 Documentation

Resources

• persons://all: List all persons.
• traits://all: List all traits.
• persons://{name}: Get a person by name.

Tools

• create_person: Create a new person.
• add_description: Add a description to a person.
• create_trait: Create a new trait.
• find_matches: Find individuals who match a job description.

📄 License

This project is licensed under the MIT-0 License.

📦 Dependencies

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