Merge branch 'main' into fix/tool-execution-mode

Author: LucaButBoring

docs/docs/develop/build-server.mdx

@@ -59,7 +59,7 @@ Writing to stdout will corrupt the JSON-RPC messages and break your server.
 ### Best Practices
 
 1. Use a logging library that writes to stderr or files.
-1. Tool names should follow the format specified [here](/specification/draft/server/tools#tool-names).
+1. For Python, be especially careful - `print()` writes to stdout by default.
 
 ### Quick Examples
 

docs/examples.mdx

@@ -19,37 +19,11 @@ These official reference servers demonstrate core MCP features and SDK usage:
 - **[Sequential Thinking](https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking)** - Dynamic and reflective problem-solving through thought sequences
 - **[Time](https://github.com/modelcontextprotocol/servers/tree/main/src/time)** - Time and timezone conversion capabilities
 
-### Archived servers (historical reference)
+### Additional example servers (archived)
 
-⚠️ **Note**: The following servers have been moved to the [servers-archived repository](https://github.com/modelcontextprotocol/servers-archived) and are no longer actively maintained. They are provided for historical reference only.
+Visit the [servers-archived repository](https://github.com/modelcontextprotocol/servers-archived) to get access to archived example servers that are no longer actively maintained.
 
-#### Data and file systems
-
-- **[PostgreSQL](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/postgres)** - Read-only database access with schema inspection capabilities
-- **[SQLite](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/sqlite)** - Database interaction and business intelligence features
-- **[Google Drive](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/gdrive)** - File access and search capabilities for Google Drive
-
-#### Development tools
-
-- **[Git](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/git)** - Tools to read, search, and manipulate Git repositories
-- **[GitHub](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/github)** - Repository management, file operations, and GitHub API integration
-- **[GitLab](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/gitlab)** - GitLab API integration enabling project management
-- **[Sentry](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/sentry)** - Retrieving and analyzing issues from Sentry.io
-
-#### Web and browser automation
-
-- **[Brave Search](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/brave-search)** - Web and local search using Brave's Search API
-- **[Puppeteer](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/puppeteer)** - Browser automation and web scraping capabilities
-
-#### Productivity and communication
-
-- **[Slack](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/slack)** - Channel management and messaging capabilities
-- **[Google Maps](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/google-maps)** - Location services, directions, and place details
-
-#### AI and specialized tools
-
-- **[EverArt](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/everart)** - AI image generation using various models
-- **[AWS KB Retrieval](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/aws-kb-retrieval-server)** - Retrieval from AWS Knowledge Base using Bedrock Agent Runtime
+They are provided for historical reference only.
 
 ## Official integrations
 

package.json

@@ -30,9 +30,9 @@
     "check:schema:json": "tsx scripts/generate-schemas.ts --check",
     "check:schema:md": "for f in schema/*/schema.mdx; do typedoc --entryPoints \"${f%.mdx}.ts\" --schemaPageTemplate \"$f\" | cmp docs/specification/$(basename -- $(dirname -- \"$f\"))/schema.mdx - || exit 1; done",
     "format": "prettier --write \"**/*.{md,mdx}\" --ignore \"docs/specification/*/schema.mdx\" ",
-    "generate:schema": "npm run generate:schema:json && npm run generate:schema:md",
+    "generate:schema": "npm run generate:schema:json & npm run generate:schema:md & wait",
     "generate:schema:json": "tsx scripts/generate-schemas.ts",
-    "generate:schema:md": "for f in schema/*/schema.mdx; do typedoc --entryPoints \"${f%.mdx}.ts\" --schemaPageTemplate \"$f\" > docs/specification/$(basename -- $(dirname -- \"$f\"))/schema.mdx; done",
+    "generate:schema:md": "find schema/*/schema.mdx -print0 | xargs -0 -P 0 -I {} sh -c 'f=\"{}\"; typedoc --entryPoints \"${f%.mdx}.ts\" --schemaPageTemplate \"$f\" > docs/specification/$(basename -- $(dirname -- \"$f\"))/schema.mdx'",
     "prep:changes": "npm run check:schema:ts && npm run generate:schema && npm run check:docs && npm run format",
     "serve:docs": "cd docs && npx mint dev",
     "serve:blog": "cd blog && hugo serve"

scripts/generate-schemas.ts

@@ -1,14 +1,20 @@
 #!/usr/bin/env tsx
 
-import { execSync } from 'child_process';
+import { exec } from 'child_process';
 import { readFileSync, writeFileSync } from 'fs';
 import { join } from 'path';
+import { promisify } from 'util';
+
+const execAsync = promisify(exec);
 
 // Legacy schema versions that should remain as JSON Schema draft-07
 const LEGACY_SCHEMAS = ['2024-11-05', '2025-03-26', '2025-06-18'];
 
+// Modern schema versions that use JSON Schema 2020-12
+const MODERN_SCHEMAS = ['2025-11-25', 'draft'];
+
 // All schema versions to generate
-const ALL_SCHEMAS = [...LEGACY_SCHEMAS, '2025-11-25', 'draft'];
+const ALL_SCHEMAS = [...LEGACY_SCHEMAS, ...MODERN_SCHEMAS];
 
 // Check if we're in check mode (validate existing schemas match generated ones)
 const CHECK_MODE = process.argv.includes('--check');
@@ -43,22 +49,19 @@ function applyJsonSchema202012Transformations(schemaPath: string): void {
 /**
  * Generate JSON schema for a specific version
  */
-function generateSchema(version: string, check: boolean = false): boolean {
+async function generateSchema(version: string, check: boolean = false): Promise<boolean> {
   const schemaDir = join('schema', version);
   const schemaTs = join(schemaDir, 'schema.ts');
   const schemaJson = join(schemaDir, 'schema.json');
 
   if (check) {
-    console.log(`Checking schema for ${version}...`);
-
     // Read existing schema
     const existingSchema = readFileSync(schemaJson, 'utf-8');
 
     // Generate schema to stdout and capture it
     try {
-      const generated = execSync(
-        `npx typescript-json-schema --defaultNumberType integer --required --skipLibCheck "${schemaTs}" "*"`,
-        { encoding: 'utf-8' }
+      const { stdout: generated } = await execAsync(
+        `npx typescript-json-schema --defaultNumberType integer --required --skipLibCheck "${schemaTs}" "*"`
       );
 
       let expectedSchema = generated;
@@ -86,13 +89,10 @@ function generateSchema(version: string, check: boolean = false): boolean {
       throw error;
     }
   } else {
-    console.log(`Generating schema for ${version}...`);
-
     // Run typescript-json-schema
     try {
-      execSync(
-        `npx typescript-json-schema --defaultNumberType integer --required --skipLibCheck "${schemaTs}" "*" -o "${schemaJson}"`,
-        { stdio: 'inherit' }
+      await execAsync(
+        `npx typescript-json-schema --defaultNumberType integer --required --skipLibCheck "${schemaTs}" "*" -o "${schemaJson}"`
       );
     } catch (error) {
       console.error(`Failed to generate schema for ${version}`);
@@ -101,28 +101,26 @@ function generateSchema(version: string, check: boolean = false): boolean {
 
     // Apply transformations for non-legacy schemas
     if (!LEGACY_SCHEMAS.includes(version)) {
-      console.log(`Applying JSON Schema 2020-12 transformations to ${version}...`);
       applyJsonSchema202012Transformations(schemaJson);
     }
 
+    console.log(`  ✓ Generated schema for ${version}`);
     return true;
   }
 }
 
 /**
  * Main function
  */
-function main(): void {
+async function main(): Promise<void> {
   if (CHECK_MODE) {
-    console.log('Checking JSON schemas...\n');
+    console.log('Checking JSON schemas in parallel...\n');
 
-    let allValid = true;
-    for (const version of ALL_SCHEMAS) {
-      const valid = generateSchema(version, true);
-      if (!valid) {
-        allValid = false;
-      }
-    }
+    const results = await Promise.all(
+      ALL_SCHEMAS.map(version => generateSchema(version, true))
+    );
+
+    const allValid = results.every(valid => valid);
 
     console.log();
     if (!allValid) {
@@ -132,16 +130,19 @@ function main(): void {
       console.log('All schemas are up to date!');
     }
   } else {
-    console.log('Generating JSON schemas...\n');
+    console.log('Generating JSON schemas in parallel...\n');
 
-    for (const version of ALL_SCHEMAS) {
-      generateSchema(version, false);
-    }
+    await Promise.all(
+      ALL_SCHEMAS.map(version => generateSchema(version, false))
+    );
 
     console.log('\nSchema generation complete!');
     console.log(`- (draft-07): ${LEGACY_SCHEMAS.join(', ')}`);
-    console.log(`- (2020-12): draft`);
+    console.log(`- (2020-12): ${MODERN_SCHEMAS.join(', ')}`);
   }
 }
 
-main();
+main().catch(error => {
+  console.error('Schema generation failed:', error);
+  process.exit(1);
+});