DotnetTest.Mcp 0.0.1-beta.4

dotnet-test-mcp

An MCP server that lets AI assistants discover and run .NET tests via dotnet test. Designed exclusively for projects using Microsoft Testing Platform (MTP) v2 — VSTest-based projects are not supported.

Tools

Requirements

• .NET 10.0 SDK
• Test projects using Microsoft Testing Platform (MTP) v2 — VSTest-based projects are not supported. MTP v2 is supported by all major test frameworks (xUnit, NUnit, MSTest, TUnit).
• xUnit (required for CTRF report generation)

Note: MTP v2 requires opting in via global.json at your repository or solution root:

{
  "test": {
    "runner": "Microsoft.Testing.Platform"
  }
}

Installation

Install as a global .NET tool from NuGet:

dotnet tool install --global DotnetTest.Mcp

Or as a local tool in your project/solution:

dotnet tool install --local DotnetTest.Mcp

Setup

Add to your MCP client config (e.g. claude_desktop_config.json):

Using the installed NuGet tool (recommended):

{
  "mcpServers": {
    "dotnet-test-mcp": {
      "command": "dotnet-test-mcp"
    }
  }
}

Using dotnet run from source:

{
  "mcpServers": {
    "dotnet-test-mcp": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/dotnet-test-mcp/src/DotnetTest.Mcp", "-c", "Release"]
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Environment Variables

These are only needed in special cases. By default, the server uses the directory it is launched from as the working directory, which most AI tools set automatically to the root of your open project.

Building

git clone https://github.com/jonasha/dotnet-test-mcp.git
cd dotnet-test-mcp
dotnet build -c Release

Troubleshooting

• No test projects found: Check WORKING_DIRECTORY and TESTS_DIRECTORY_NAME match your structure
• No tests matched: Use ListTestsSummary first to find the correct fully qualified name
• CTRF errors: Confirm you're using xUnit 3.0+ with CTRF support

License

MIT — see LICENSE