How do I install the Test MCP Compliance skill?

Run npx skillmds@latest add majiayu000/test-mcp-compliance-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Test MCP Compliance safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Test MCP Compliance?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Test MCP Compliance free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Test MCP Compliance?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Test MCP Compliance by majiayu000 — Agent Skill

Name: Test MCP Compliance
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

MCP Compliance Validation Skill

Purpose

Validates Model Context Protocol (MCP) compliance by running the official compliance test suite against the Pierre server.

CLAUDE.md Compliance

✅ Uses existing validation script (no new code)
✅ No external dependencies beyond test suite
✅ Deterministic test execution

Usage

Run this skill before:

Protocol handler changes
Tool modifications
SDK releases
Production deployments

Prerequisites

mcp-compliance repository cloned to ../mcp-compliance/
Pierre server must be runnable

Commands

Quick Validation

# Ensure mcp-compliance repo exists and run tests
./scripts/ci/ensure-mcp-compliance.sh

Detailed Validation

# 1. Ensure compliance suite is installed
./scripts/ci/ensure-mcp-compliance.sh

# 2. Start Pierre server
cargo run --bin pierre-mcp-server &
SERVER_PID=$!
sleep 3

# 3. Run compliance tests
cd ../mcp-compliance
bun test -- --server="http://localhost:8081/mcp"
TEST_RESULT=$?
cd -

# 4. Cleanup
kill $SERVER_PID

# 5. Exit with test result
exit $TEST_RESULT

Manual Compliance Check

# Check JSON-RPC 2.0 compliance
rg "jsonrpc.*2\.0" src/mcp/ --type rust -n | head -10

# Verify error code compliance
rg "error.*code.*-32[0-9]{3}" src/mcp/ --type rust -A 3 | head -20

# Check tool schema format
rg "struct ToolDefinition|inputSchema" src/protocols/universal/tool_registry.rs --type rust -A 10 | head -30

Success Criteria

✅ All MCP compliance tests pass
✅ JSON-RPC 2.0 format validated
✅ Tool schemas match specification
✅ Error responses properly formatted

Troubleshooting

Issue: mcp-compliance repo not found

# Clone the compliance suite
git clone https://github.com/modelcontextprotocol/mcp-compliance ../mcp-compliance
cd ../mcp-compliance
bun install
cd -

Issue: Server won't start

# Check if port 8081 is in use
lsof -i :8081
# Kill existing process or use different port

Issue: Tests timeout

# Increase timeout in compliance suite
# Or run server separately and ensure it's responsive
curl -X POST http://localhost:8081/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Related Files

scripts/ci/ensure-mcp-compliance.sh - Compliance runner script
src/mcp/protocol.rs - MCP protocol implementation
src/protocols/universal/tool_registry.rs - Tool definitions

Related Skills

run-full-test-suite - Full test suite execution

---name: test-mcp-compliance-2description: Validates Model Context Protocol (MCP) compliance by running official compliance test suite against Pierre server---# MCP Compliance Validation Skill## PurposeValidates Model Context Protocol (MCP) compliance by running the official compliance test suite against the Pierre server.## CLAUDE.md Compliance- ✅ Uses existing validation script (no new code)- ✅ No external dependencies beyond test suite- ✅ Deterministic test execution## UsageRun this skill before:- Protocol handler changes- Tool modifications- SDK releases- Production deployments## Prerequisites- `mcp-compliance` repository cloned to `../mcp-compliance/`- Pierre server must be runnable## Commands### Quick Validation```bash# Ensure mcp-compliance repo exists and run tests./scripts/ci/ensure-mcp-compliance.sh```### Detailed Validation```bash# 1. Ensure compliance suite is installed./scripts/ci/ensure-mcp-compliance.sh# 2. Start Pierre servercargo run --bin pierre-mcp-server &SERVER_PID=$!sleep 3# 3. Run compliance testscd ../mcp-compliancebun test -- --server="http://localhost:8081/mcp"TEST_RESULT=$?cd -# 4. Cleanupkill $SERVER_PID# 5. Exit with test resultexit $TEST_RESULT```### Manual Compliance Check```bash# Check JSON-RPC 2.0 compliancerg "jsonrpc.*2\.0" src/mcp/ --type rust -n | head -10# Verify error code compliancerg "error.*code.*-32[0-9]{3}" src/mcp/ --type rust -A 3 | head -20# Check tool schema formatrg "struct ToolDefinition|inputSchema" src/protocols/universal/tool_registry.rs --type rust -A 10 | head -30```## Success Criteria- ✅ All MCP compliance tests pass- ✅ JSON-RPC 2.0 format validated- ✅ Tool schemas match specification- ✅ Error responses properly formatted## Troubleshooting**Issue:** `mcp-compliance` repo not found```bash# Clone the compliance suitegit clone https://github.com/modelcontextprotocol/mcp-compliance ../mcp-compliancecd ../mcp-compliancebun installcd -```**Issue:** Server won't start```bash# Check if port 8081 is in uselsof -i :8081# Kill existing process or use different port```**Issue:** Tests timeout```bash# Increase timeout in compliance suite# Or run server separately and ensure it's responsivecurl -X POST http://localhost:8081/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'```## Related Files- `scripts/ci/ensure-mcp-compliance.sh` - Compliance runner script- `src/mcp/protocol.rs` - MCP protocol implementation- `src/protocols/universal/tool_registry.rs` - Tool definitions## Related Skills- `run-full-test-suite` - Full test suite execution

Frequently asked questions

Test MCP Compliance