MCP Testing Sensei

Provides an MCP stdio server that lints code, exposes testing principles, and guides tool behavior.

python

0

GitHub Stars

python

Language

7 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": {
    "kourtni-mcp-testing-sensei": {
      "command": "./result/bin/mcp-testing-sensei",
      "args": []
    }
  }
}

MCP Testing Sensei provides an MCP stdio server that guides agentic coding tools to follow language-agnostic unit testing principles. It runs in stdio mode and communicates via JSON-RPC over standard input and output, enabling integration with MCP clients to enforce and demonstrate clear, declarative testing practices.

How to use

You run the MCP stdio server and connect an MCP client to it. The server listens for JSON-RPC messages on standard input and writes responses to standard output, enabling tools to request guidance, lint code, and retrieve testing principles. Use this to ensure your tools generate pre-implementation tests that document behavior, stay deterministic, and avoid branching logic.

Start by choosing how you want to run the server. You can run a prebuilt standalone executable or start the server from your development environment. Once the server is running, configure your MCP client to point at the server and begin issuing requests to lint code snippets and fetch the core testing principles.

How to install

Prerequisites: you should have a compatible runtime installed on your system. You can run the server as a standalone executable, install it via Python, or run it in a container. Follow the option that matches your workflow.

Option 1 – Standalone Executable (no Python required) Download the pre-built executable for your platform from the latest release.

Linux: mcp-testing-sensei-linux
macOS: mcp-testing-sensei-macos
Windows: mcp-testing-sensei-windows.exe

Make the file executable (Linux/macOS):
chmod +x mcp-testing-sensei-linux
./mcp-testing-sensei-linux

Option 2 – Install from PyPI

If you have Python installed, you can install the MCP server globally using pip.

pip install mcp-testing-sensei

Option 3 – Install from npm

If you prefer npm, you can install the MCP server globally via npm. Note that Python must be installed on your system.

npm install -g @kourtni/mcp-testing-sensei

Option 4 – Using Docker

Run the MCP server inside a Docker container.

docker pull kourtni/mcp-testing-sensei

Option 5 – Development Setup with Nix

For development or building from source, use a reproducible Nix environment.

Prerequisites: Nix

nix develop

Building the Standalone Executable

If you are using Nix for development, you can build the standalone executable.

nix build

This creates a result symlink in your project root pointing to the built executable.

Running the Server

Option A – Run the standalone executable after building.

./result/bin/mcp-testing-sensei

Running from Development Environment

If you are in a development environment, you can run the server directly with Python.

python mcp_server.py

Available tools

lint_code

Analyzes provided code snippets for violations of the defined unit testing standards.

get_testing_principles

Provides the core unit testing principles to guide LLMs in generating better tests.

unit-testing-principles

Exposes testing principles as an MCP resource.