Name: sercanbayrambey/MCP-Doctor
Rating: 3.2 (1 reviews)
Author: sercanbayrambey

sercanbayrambey/MCP-Doctor

Score: 55.8 Rank #17

Automated testing and validation framework for MCP server tools

Overview

sercanbayrambey/MCP-Doctor is a JavaScript MCP server licensed under MIT. Automated testing and validation framework for MCP server tools

Ranked #17 out of 104 indexed tools.

Actively maintained with commits in the last week.

Ecosystem

JavaScript MIT

Score Breakdown

Stars 15% 2

2 stars → early stage

Freshness 25% 2d ago

Last commit 2d ago → actively maintained

Issue Health 25% 50%

No issues filed → no history to score

Contributors 10% 2

2 contributors → solo project

Dependents 25% 0

No dependents → no downstream usage

Forks 0

Description Good

License MIT

Weights: Freshness 25% · Issue Health 25% · Dependents 25% · Stars 15% · Contributors 10% · How we score →

How to Improve

Description low impact

Expand your description to 150+ characters for better discoverability

Dependents medium impact

No downstream dependents detected yet — adoption by other projects is the strongest trust signal

Badge

Markdown

[![AgentRank](https://agentrank-ai.com/api/badge/tool/sercanbayrambey--MCP-Doctor)](https://agentrank-ai.com/tool/sercanbayrambey--MCP-Doctor/?utm_source=badge&utm_medium=readme&utm_campaign=agentrank_badge)

HTML

<a href="https://agentrank-ai.com/tool/sercanbayrambey--MCP-Doctor/?utm_source=badge&utm_medium=readme&utm_campaign=agentrank_badge"><img src="https://agentrank-ai.com/api/badge/tool/sercanbayrambey--MCP-Doctor" alt="AgentRank"></a>

Embed Widget docs →

HTML

<script src="https://agentrank-ai.com/embed.js" data-tool="sercanbayrambey/MCP-Doctor"></script>

Details

Stars: 2
Forks: 0
Open Issues: 0
Closed Issues: 0
Contributors: 2
Dependents: —
Language: JavaScript
License: MIT
Last Commit: 2d ago

Matched Queries

"mcp server""mcp-server"

From the README

# mcp-doctor

Automated testing and validation framework for MCP server tools.

## How It Works

1. Fetches tool list from server via configured endpoint
2. Loads test cases from JSON files in `tools/` directory
3. Calls each tool with the provided request data
4. Compares responses with expected values

## Setup

```bash
npm install
cp .env.example .env
cp base-request.example.json base-request.json
cp variables.example.json variables.json
```

## Configuration

### Environment Variables (`.env`)

```env
MCP_SERVER_URL=http://localhost:3000
MCP_PROTOCOL=mcp                    # "mcp" (JSON-RPC) or "rest"

# Single endpoint (MCP spec standard - streamable HTTP)
MCP_ENDPOINT=/mcp

# Or separate endpoints (legacy/custom setups)
# TOOLS_LIST_ENDPOINT=/tools/list
# TOOLS_CALL_ENDPOINT=/tools/call

REQUEST_TIMEOUT=30000
TOOLS_DIR=./tools
BASE_REQUEST_PATH=./base-request.json
VARIABLES_PATH=./variables.json     # Variables for test cases
OUTPUT_FORMAT=console               # "console", "json

Read full README on GitHub →