MBTI

Stateless MBTI MCP server that guides you through 28-question quick test or 48-question cognitive test and returns detailed results.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "wenyili-mbti-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mbti-mcp"
      ],
      "env": {
        "YOUR_ENV_VAR": "VALUE"
      }
    }
  }
}

This MBTI MCP Server guides users through two MBTI testing modes in a stateless MCP framework. You interact with an MCP client to start a test, answer questions on a 1–5 scale, monitor progress, and obtain a final MBTI type with scores and descriptions. It emphasizes transfer of test state via JSON between tool calls without persisting data on the server.

How to use

You will perform MBTI testing through an MCP client by selecting a test type, answering questions on a 1–5 scale, checking progress, and finally receiving your MBTI type along with detailed scores per dimension or cognitive function.

Step-by-step flow you can follow: start the test and choose either the Simplified (28 questions) or Cognitive (48 questions) mode, answer each item with your level of agreement, optionally query progress, and when all questions are answered, calculate your MBTI result.

Key actions you will perform with the MCP tools include starting the test, submitting answers, requesting progress, and computing the final result. The server returns the next question after each answer and a session object that carries your state between steps.

How to install

Prerequisites you need before installing: Node.js for running MCP components and a capable MCP client to communicate with the server.

Choose one of the installation methods below and configure your MCP client accordingly.

Using npx (recommended; no global install required) create or edit your MCP client config to point to the npx-based server launcher.

方式1：使用npx（推荐，无需安装）

{
  "mcpServers": {
    "mbti": {
      "command": "npx",
      "args": ["-y", "mbti-mcp"]
    }
  }
}

方式2：全局安装

Install the package globally and configure your MCP client to use it.

npm install -g mbti-mcp

{
  "mcpServers": {
    "mbti": {
      "command": "mbti-mcp"
    }
  }
}

方式3：从源码安装

Clone the project, install dependencies, and build the server, then configure your MCP client to run the built index file.

git clone https://github.com/wenyili/mbti-mcp.git
cd mbti-mcp
pnpm install
pnpm build

{
  "mcpServers": {
    "mbti": {
      "command": "node",
      "args": ["<项目路径>/dist/index.js"]
    }
  }
}

Available tools

start_mbti_test

Starts the MBTI test flow and returns the initial question and session state. You choose between simplified and cognitive modes.

answer_question

Submits your answer score for the current question and returns the next question with an updated session.

get_progress

Returns the current progress and session state to show how many questions remain.

calculate_mbti_result

Calculates and returns the final MBTI type, along with per-dimension scores and a descriptive interpretation.