Merge pull request #1 from modelcontextprotocol/chore/scaffolding

Initial project structure for MCP variants

typescript/sdk/.eslintrc.json

@@ -0,0 +1,24 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module",
+    "project": "./tsconfig.json"
+  },
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:@typescript-eslint/recommended-requiring-type-checking"
+  ],
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "rules": {
+    "@typescript-eslint/explicit-module-boundary-types": "error",
+    "@typescript-eslint/no-explicit-any": "error",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }]
+  }
+}

typescript/sdk/.nvmrc

@@ -0,0 +1 @@
+20

typescript/sdk/README.md

@@ -0,0 +1,3 @@
+# MCP Variants - TypeScript Implementation
+
+This will contain the TypeScript implementation of the MCP Variants based on [SEP-2053](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2053).

typescript/sdk/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ext-modelcontextprotocol/variants",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Model Context Protocol variants",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "variants"
+  ],
+  "author": "The MCP Variants Authors",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/modelcontextprotocol/experimental-ext-variants.git",
+    "directory": "typescript/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/modelcontextprotocol/experimental-ext-variants/issues"
+  },
+  "homepage": "https://github.com/modelcontextprotocol/experimental-ext-variants",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  }
+}

typescript/sdk/src/index.ts

@@ -0,0 +1,11 @@
+// Copyright 2025 The MCP Variants Authors. All rights reserved.
+// Use of this source code is governed by a Apache-2.0
+// license that can be found in the LICENSE file.
+
+/**
+ * MCP Variants TypeScript SDK
+ *
+ * Implements experimental MCP Variants for extended functionality.
+ */
+
+export * from './variants.js';

typescript/sdk/src/variants.test.ts

@@ -0,0 +1,11 @@
+// Copyright 2025 The MCP Variants Authors. All rights reserved.
+// Use of this source code is governed by a Apache-2.0
+// license that can be found in the LICENSE file.
+
+import { describe, it, expect } from 'vitest';
+
+describe('Variants', () => {
+  it('should be defined', () => {
+    expect(true).toBe(true);
+  });
+});

typescript/sdk/src/variants.ts

@@ -0,0 +1,11 @@
+// Copyright 2025 The MCP Variants Authors. All rights reserved.
+// Use of this source code is governed by a Apache-2.0
+// license that can be found in the LICENSE file.
+
+/**
+ * Core variant functionality for MCP
+ *
+ * Experimental variant implementations for extended MCP functionality.
+ */
+
+// Placeholder for variant implementation

typescript/sdk/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "NodeNext",
+    "lib": ["esnext"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "NodeNext",
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

typescript/sdk/vitest.config.js

@@ -0,0 +1,10 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['src/**/*.test.ts', 'test/**/*.test.ts'],
+    exclude: ['**/node_modules/**', '**/dist/**']
+  }
+});