Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1,120 changes: 0 additions & 1,120 deletions SERVER_REQUIREMENTS.md

This file was deleted.

11 changes: 0 additions & 11 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

5 changes: 4 additions & 1 deletion src/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,10 @@ program
validated.scenario
);

const { failed } = printServerResults(result.checks);
const { failed } = printServerResults(
result.checks,
result.scenarioDescription
);
process.exit(failed > 0 ? 1 : 0);
} else {
// Run all active scenarios
Expand Down
27 changes: 23 additions & 4 deletions src/runner/server.ts
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,26 @@ import { ConformanceCheck } from '../types';
import { getClientScenario } from '../scenarios';
import { ensureResultsDir, createResultDir } from './utils';

/**
* Format markdown-style text for terminal output using ANSI codes
*/
function formatMarkdown(text: string): string {
return (
text
// Bold text: **text** -> bold
.replace(/\*\*([^*]+)\*\*/g, '\x1b[1m$1\x1b[0m')
// Inline code: `code` -> dim/gray
.replace(/`([^`]+)`/g, '\x1b[2m$1\x1b[0m')
);
}

export async function runServerConformanceTest(
serverUrl: string,
scenarioName: string
): Promise<{
checks: ConformanceCheck[];
resultDir: string;
scenarioDescription: string;
}> {
await ensureResultsDir();
const resultDir = createResultDir(scenarioName, 'server');
Expand All @@ -33,11 +47,15 @@ export async function runServerConformanceTest(

return {
checks,
resultDir
resultDir,
scenarioDescription: scenario.description
};
}

export function printServerResults(checks: ConformanceCheck[]): {
export function printServerResults(
checks: ConformanceCheck[],
scenarioDescription: string
): {
passed: number;
failed: number;
denominator: number;
Expand All @@ -54,14 +72,15 @@ export function printServerResults(checks: ConformanceCheck[]): {
console.log(`Passed: ${passed}/${denominator}, ${failed} failed`);

if (failed > 0) {
console.log('\nFailed Checks:');
console.log('\n=== Failed Checks ===');
checks
.filter((c) => c.status === 'FAILURE')
.forEach((c) => {
console.log(` - ${c.name}: ${c.description}`);
console.log(`\n - ${c.name}: ${c.description}`);
if (c.errorMessage) {
console.log(` Error: ${c.errorMessage}`);
}
console.log(`\n${formatMarkdown(scenarioDescription)}`);
});
}

Expand Down
25 changes: 23 additions & 2 deletions src/scenarios/server/elicitation-defaults.ts
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,29 @@ import { ElicitRequestSchema } from '@modelcontextprotocol/sdk/types.js';

export class ElicitationDefaultsScenario implements ClientScenario {
name = 'elicitation-sep1034-defaults';
description =
'Test elicitation with default values for all primitive types (SEP-1034)';
description = `Test elicitation with default values for all primitive types (SEP-1034).

**Server Implementation Requirements:**

Implement a tool named \`test_elicitation_sep1034_defaults\` (no arguments) that requests \`elicitation/create\` from the client with a schema containing default values for all primitive types:
- \`name\` (string): default "John Doe"
- \`age\` (integer): default 30
- \`score\` (number): default 95.5
- \`status\` (string enum: ["active", "inactive", "pending"]): default "active"
- \`verified\` (boolean): default true

**Returns**: Text content with the elicitation result

\`\`\`json
{
"content": [
{
"type": "text",
"text": "Elicitation completed: action=<accept/decline/cancel>, content={...}"
}
]
}
\`\`\``;

async run(serverUrl: string): Promise<ConformanceCheck[]> {
const checks: ConformanceCheck[] = [];
Expand Down
25 changes: 24 additions & 1 deletion src/scenarios/server/elicitation-enums.ts
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,30 @@ import { ElicitRequestSchema } from '@modelcontextprotocol/sdk/types.js';

export class ElicitationEnumsScenario implements ClientScenario {
name = 'elicitation-sep1330-enums';
description = 'Test elicitation with enum schema improvements (SEP-1330)';
description = `Test elicitation with enum schema improvements (SEP-1330).

**Server Implementation Requirements:**

Implement a tool named \`test_elicitation_sep1330_enums\` (no arguments) that requests \`elicitation/create\` from the client with a schema containing all 5 enum variants:

1. **Untitled single-select**: \`{ type: "string", enum: ["option1", "option2", "option3"] }\`
2. **Titled single-select**: \`{ type: "string", oneOf: [{ const: "value1", title: "First Option" }, ...] }\`
3. **Legacy titled (deprecated)**: \`{ type: "string", enum: ["opt1", "opt2", "opt3"], enumNames: ["Option One", "Option Two", "Option Three"] }\`
4. **Untitled multi-select**: \`{ type: "array", items: { type: "string", enum: ["option1", "option2", "option3"] } }\`
5. **Titled multi-select**: \`{ type: "array", items: { anyOf: [{ const: "value1", title: "First Choice" }, ...] } }\`

**Returns**: Text content with the elicitation result

\`\`\`json
{
"content": [
{
"type": "text",
"text": "Elicitation completed: action=<accept/decline/cancel>, content={...}"
}
]
}
\`\`\``;

async run(serverUrl: string): Promise<ConformanceCheck[]> {
const checks: ConformanceCheck[] = [];
Expand Down
13 changes: 12 additions & 1 deletion src/scenarios/server/lifecycle.ts
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,18 @@ import { connectToServer } from './client-helper.js';

export class ServerInitializeScenario implements ClientScenario {
name = 'server-initialize';
description = 'Test basic server initialization handshake';
description = `Test basic server initialization handshake.

**Server Implementation Requirements:**

**Endpoint**: \`initialize\`

**Requirements**:
- Accept \`initialize\` request with client info and capabilities
- Return valid initialize response with server info, protocol version, and capabilities
- Accept \`initialized\` notification from client after handshake

This test verifies the server can complete the two-phase initialization handshake successfully.`;

async run(serverUrl: string): Promise<ConformanceCheck[]> {
const checks: ConformanceCheck[] = [];
Expand Down
Loading
Loading