# SRQuiz MCP Server

An MCP (Model Context Protocol) server providing science-based psychometric tools and sexual well-being assessments for AI agents.

[![glama](https://img.shields.io/badge/glama-MCP-blue)](https://glama.ai/mcp/servers)
[![smithery](https://img.shields.io/badge/smithery-MCP-green)](https://smithery.ai)

## 🌟 Overview

The SRQuiz MCP Server empowers AI assistants (like Claude and Cursor) to provide scientifically grounded insights into sexual psychology. It bridges the gap between conversational AI and structured psychometric knowledge, specifically related to the Dual Control Model, sexual guilt, and sexual shame.

- **Website**: [srquiz.com](https://srquiz.com)
- **API/MCP Documentation**: [srquiz.com/mcp](https://srquiz.com/mcp)
- **Scientific Basis**: [srquiz.com/science](https://srquiz.com/science)

## 🛠 Features (Tools)

- `get_sri_questionnaire`: Retrieves standard assessment questions based on validated psychometric scales (e.g., SIS/SES).
- `calculate_sri_score`: Calculates standardized scores and interpretations from user responses.
- `search_sexual_psychology_kb`: Access scientific explanations regarding core concepts like the Dual Control Model, Sexual Guilt, and Sexual Shame.

## 🚀 Installation & Usage

### Usage with Claude Desktop

To use this server with the Claude Desktop app, add the following configuration to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "srquiz-psychometrics": {
      "command": "npx",
      "args": ["-y", "@srquiz/mcp-server"]
    }
  }
}
```

### Usage with Cursor

1. Open Cursor Settings.
2. Go to the **Features** tab -> **MCP** section.
3. Click **+ Add New MCP Server**.
4. Choose **Command** type.
5. Name: `srquiz-mcp`
6. Command: `npx -y @srquiz/mcp-server`

## 📦 Development

```bash
# Install dependencies
npm install

# Build the project
npm run build

# Start the server locally
npm start
```

## 🔒 Privacy

The SRQuiz MCP Server operates completely locally. It does not send any user assessment data back to srquiz.com. All calculations and logic are handled by the server instance running on your machine.

## 📄 License

MIT