feat(sdk): added npm MCP server

release: 0.4.0

Author: umarbutler

.github/workflows/publish-npm.yml

@@ -4,6 +4,10 @@
 name: Publish NPM
 on:
   workflow_dispatch:
+    inputs:
+      path:
+        description: The path to run the release in, e.g. '.' or 'packages/mcp-server'
+        required: true
 
   release:
     types: [published]
@@ -27,6 +31,11 @@ jobs:
 
       - name: Publish to NPM
         run: |
-          bash ./bin/publish-npm
+          if [ -n "${{ github.event.inputs.path }}" ]; then
+            PATHS_RELEASED='[\"${{ github.event.inputs.path }}\"]'
+          else
+            PATHS_RELEASED='[\".\", \"packages/mcp-server\"]'
+          fi
+          yarn tsn scripts/publish-packages.ts "{ \"paths_released\": \"$PATHS_RELEASED\" }"
         env:
           NPM_TOKEN: ${{ secrets.ISAACUS_NPM_TOKEN || secrets.NPM_TOKEN }}

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.3.1"
+  ".": "0.4.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 2
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-861e8a85f0fb73cf4b7fc6c2b27722072ff33109459e90c17be24af15dfcbd0c.yml
 openapi_spec_hash: 644a0383600633ee604bb1e5b9ca025d
-config_hash: 2bc262108dc3b065c16da5bb85c1e282
+config_hash: 1d603d50b7183a492ad6df5f728a1863

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.4.0 (2025-04-01)
+
+Full Changelog: [v0.3.1...v0.4.0](https://github.com/isaacus-dev/isaacus-typescript/compare/v0.3.1...v0.4.0)
+
+### Features
+
+* **sdk:** added npm MCP server ([#30](https://github.com/isaacus-dev/isaacus-typescript/issues/30)) ([efe94d9](https://github.com/isaacus-dev/isaacus-typescript/commit/efe94d984a395de1c3f78db9851937e22971b6aa))
+
 ## 0.3.1 (2025-04-01)
 
 Full Changelog: [v0.3.0...v0.3.1](https://github.com/isaacus-dev/isaacus-typescript/compare/v0.3.0...v0.3.1)

eslint.config.mjs

@@ -34,7 +34,7 @@ export default tseslint.config(
     },
   },
   {
-    files: ['tests/**', 'examples/**'],
+    files: ['tests/**', 'examples/**', 'packages/**'],
     rules: {
       'no-restricted-imports': 'off',
     },

package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacus",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "The official TypeScript library for the Isaacus API",
   "author": "Isaacus <[email protected]>",
   "types": "dist/index.d.ts",

packages/mcp-server/README.md

@@ -0,0 +1,32 @@
+# Isaacus TypeScript MCP Server
+
+It is generated with [Stainless](https://www.stainless.com/).
+
+## Installation
+
+### Via Claude Desktop
+
+See [the user guide](https://modelcontextprotocol.io/quickstart/user) for setup.
+
+Once it's set up, add your MCP server to your `claude_desktop_config.json` file to enable it.
+
+The configuration file should be at:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Add the following value to your `mcpServers` section. Make sure to provide any necessary environment variables (like API keys) as well.
+
+```json
+{
+  "mcpServers": {
+    "isaacus_api": {
+      "command": "npx",
+      "args": ["-y", "isaacus-mcp"],
+      "env": {
+        "ISAACUS_API_KEY": "My API Key"
+      }
+    }
+  }
+}
+```

packages/mcp-server/build

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+set -exuo pipefail
+
+rm -rf dist; mkdir dist
+
+# Copy src to dist/src and build from dist/src into dist, so that
+# the source map for index.js.map will refer to ./src/index.ts etc
+cp -rp src README.md dist
+
+for file in LICENSE; do
+  if [ -e "../../${file}" ]; then cp "../../${file}" dist; fi
+done
+
+for file in CHANGELOG.md; do
+  if [ -e "${file}" ]; then cp "${file}" dist; fi
+done
+
+# this converts the export map paths for the dist directory
+# and does a few other minor things
+PKG_JSON_PATH=../../packages/mcp-server/package.json node ../../scripts/utils/make-dist-package-json.cjs > dist/package.json
+
+# updates the `isaacus` dependency to point to NPM
+node scripts/postprocess-dist-package-json.cjs
+
+# build to .js/.mjs/.d.ts files
+npm exec tsc-multi
+# we need to add exports = module.exports = Anthropic TypeScript to index.js;
+# No way to get that from index.ts because it would cause compile errors
+# when building .mjs
+DIST_PATH=./dist node ../../scripts/utils/fix-index-exports.cjs
+
+# with "moduleResolution": "nodenext", if ESM resolves to index.d.ts,
+# it'll have TS errors on the default import.  But if it resolves to
+# index.d.mts the default import will work (even though both files have
+# the same export default statement)
+cp dist/index.d.ts dist/index.d.mts
+cp tsconfig.dist-src.json dist/src/tsconfig.json
+
+# Add proper Node.js shebang to the top of the file
+sed -i.bak '1s;^;#!/usr/bin/env node\n;' dist/index.js
+rm dist/index.js.bak
+
+chmod +x dist/index.js
+
+DIST_PATH=./dist PKG_IMPORT_PATH=isaacus-mcp/ node ../../scripts/utils/postprocess-files.cjs

packages/mcp-server/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "isaacus-mcp",
+  "version": "0.4.0",
+  "description": "The official MCP Server for the Isaacus API",
+  "author": "Isaacus <[email protected]>",
+  "types": "dist/index.d.ts",
+  "main": "dist/index.js",
+  "type": "commonjs",
+  "repository": "github:isaacus-dev/isaacus-typescript",
+  "license": "Apache-2.0",
+  "packageManager": "[email protected]",
+  "private": false,
+  "scripts": {
+    "test": "echo 'no tests defined yet' && exit 1",
+    "build": "bash ./build",
+    "prepack": "echo 'to pack, run yarn build && (cd dist; yarn pack)' && exit 1",
+    "prepublishOnly": "echo 'to publish, run yarn build && (cd dist; yarn publish)' && exit 1",
+    "format": "prettier --write --cache --cache-strategy metadata . !dist",
+    "prepare": "npm run build",
+    "tsn": "ts-node -r tsconfig-paths/register",
+    "lint": "eslint --ext ts,js .",
+    "fix": "eslint --fix --ext ts,js ."
+  },
+  "dependencies": {
+    "isaacus": "file:../../dist/",
+    "@modelcontextprotocol/sdk": "^1.6.1"
+  },
+  "bin": {
+    "mcp-server": "dist/index.js"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.4.0",
+    "@typescript-eslint/eslint-plugin": "^6.7.0",
+    "@typescript-eslint/parser": "^6.7.0",
+    "eslint": "^8.49.0",
+    "eslint-plugin-prettier": "^5.0.1",
+    "eslint-plugin-unused-imports": "^3.0.0",
+    "jest": "^29.4.0",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.1.0",
+    "ts-morph": "^19.0.0",
+    "ts-node": "^10.5.0",
+    "tsc-multi": "^1.1.0",
+    "tsconfig-paths": "^4.0.0",
+    "typescript": "^4.8.2"
+  },
+  "imports": {
+    "isaacus-mcp": ".",
+    "isaacus-mcp/*": "./src/*"
+  },
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./*.mjs": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.mjs"
+    },
+    "./*.js": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "require": "./dist/*.js",
+      "default": "./dist/*.mjs"
+    }
+  }
+}

packages/mcp-server/scripts/postprocess-dist-package-json.cjs

@@ -0,0 +1,12 @@
+const fs = require('fs');
+const pkgJson = require('../dist/package.json');
+const parentPkgJson = require('../../../package.json');
+
+for (const dep in pkgJson.dependencies) {
+  // ensure we point to NPM instead of a local directory
+  if (dep === 'isaacus') {
+    pkgJson.dependencies[dep] = '^' + parentPkgJson.version;
+  }
+}
+
+fs.writeFileSync('dist/package.json', JSON.stringify(pkgJson, null, 2));