An interactive application for testing MCP tools.
Project description
🧑⚖️ MCP Judge
An interactive interface for testing your MCP tools. This application helps you connect to an MCP server, list available tools, inspect their schemas, and run them with custom inputs, all from a clean, web-based UI.
✨ Features
- Connect to any MCP Server: Easily connect to a new MCP server by simply entering its URL.
- Discover Tools: View a list of all available tools and their descriptions.
- Dynamic Input Forms: The app automatically generates input forms based on the tool's
inputSchema. - Live Tool Testing: Run any tool with your specified inputs and see the output in real-time.
🚀 Installation
You can install mcp-judge directly from PyPI.
pip install mcp-judge
💻 How to Run
After installation, you can launch the application from your terminal with a single command:
mcp-judge
This will automatically start a local server and open the app in your default web browser.
🛠️ Usage
- Enter Server URL: On the left side of the screen, enter the URL of the MCP server you want to test and click "Connect".
- Select a Tool: Once connected, a list of available tools will appear below. Choose the tool you want to test from the dropdown menu.
- Provide Inputs: The right side of the screen will show a form based on the selected tool's required inputs. Fill in the necessary details.
- Run the Tool: Click the "Run Tool" button to execute the tool. The output will be displayed in the "Tool Result" section below.
📄 Requirements
- Python 3.11+
🔌 Sample MCP Connections
1. Connected to Microsoft's Sample MCP
2. Connected to Custom Test MCP
🔗 Project Links
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_judge-0.1.3.tar.gz.
File metadata
- Download URL: mcp_judge-0.1.3.tar.gz
- Upload date:
- Size: 5.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
afa811123668513127cf6e949a7c2d624af05fce8c5ebb7bc5369169bf1fcf2f
|
|
| MD5 |
49ea7e80206bda5d7c64c57dbe322d54
|
|
| BLAKE2b-256 |
c1af36e4a6119bd83726c92afe30c215ae0aa99ebad939bf79b4f5f8ac1db32b
|
File details
Details for the file mcp_judge-0.1.3-py3-none-any.whl.
File metadata
- Download URL: mcp_judge-0.1.3-py3-none-any.whl
- Upload date:
- Size: 6.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1329c7bd1b90a9f40e3f9e075d51c72472749dcae77ea96a00fb6ad615a93364
|
|
| MD5 |
cd1579d72c5ecd2532dfd32129135e1f
|
|
| BLAKE2b-256 |
8b289598ae0c2fef90ffab0ae2cc596f5cbf12923b34069e23aeb3169080234e
|
