@notionhq/notion-mcp-server 1.0.0 → 1.1.0

package/package.json

@@ -2,10 +2,11 @@
   "name": "@notionhq/notion-mcp-server",
   "keywords": [
     "notion",
+    "api",
     "mcp",
     "server"
   ],
-  "version": "1.0.0",
+  "version": "1.1.0",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -17,7 +18,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.8.0",
-    "axios": "^1.7.9",
+    "axios": "^1.8.4",
     "express": "^4.21.2",
     "form-data": "^4.0.1",
     "mustache": "^4.2.0",
@@ -35,13 +36,13 @@
     "@types/mustache": "^4.2.5",
     "@types/node": "^20.17.16",
     "@types/which": "^3.0.4",
-    "@vitest/coverage-v8": "2.1.8",
-    "esbuild": "^0.24.2",
+    "@vitest/coverage-v8": "3.1.1",
+    "esbuild": "^0.25.2",
     "multer": "1.4.5-lts.1",
-    "openai": "^4.80.1",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.3",
-    "vitest": "^2.1.8"
+    "openai": "^4.91.1",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2",
+    "vitest": "^3.1.1"
   },
   "description": "Official MCP server for Notion API",
   "main": "index.js",

package/scripts/start-server.ts

@@ -1,70 +1,28 @@
-import fs from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'url'
-
-import { OpenAPIV3 } from 'openapi-types'
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
-import OpenAPISchemaValidator from 'openapi-schema-validator'
-
-import { MCPProxy } from '../src/openapi-mcp-server/mcp/proxy'
-
-export class ValidationError extends Error {
-  constructor(public errors: any[]) {
-    super('OpenAPI validation failed')
-    this.name = 'ValidationError'
-  }
-}
-
-export async function loadOpenApiSpec(specPath: string): Promise<OpenAPIV3.Document> {
-  let rawSpec: string
-
-  try {
-    rawSpec = fs.readFileSync(path.resolve(process.cwd(), specPath), 'utf-8')
-  } catch (error) {
-    console.error('Failed to read OpenAPI specification file:', (error as Error).message)
-    process.exit(1)
-  }
 
-  // Parse and validate the spec
-  try {
-    const parsed = JSON.parse(rawSpec)
-    const baseUrl = process.env.BASE_URL
+import { initProxy, ValidationError } from '../src/init-server'
 
-    if (baseUrl) {
-      parsed.servers[0].url = baseUrl
-    }
-
-    return parsed as OpenAPIV3.Document
-  } catch (error) {
-    if (error instanceof ValidationError) {
-      throw error
-    }
-    console.error('Failed to parse OpenAPI specification:', (error as Error).message)
-    process.exit(1)
-  }
-}
-
-// Main execution
-export async function main(args: string[] = process.argv.slice(2)) {
+export async function startServer(args: string[] = process.argv.slice(2)) {
   const filename = fileURLToPath(import.meta.url)
   const directory = path.dirname(filename)
   const specPath = path.resolve(directory, '../scripts/notion-openapi.json')
-  const openApiSpec = await loadOpenApiSpec(specPath)
-  const proxy = new MCPProxy('OpenAPI Tools', openApiSpec)
+  
+  const baseUrl = process.env.BASE_URL ?? undefined
 
-  return proxy.connect(new StdioServerTransport())
-}
+  const proxy = await initProxy(specPath, baseUrl)
+  await proxy.connect(new StdioServerTransport())
 
-const shouldStart = process.argv[1].endsWith('notion-mcp-server')
-// Only run main if this is the entry point
-if (shouldStart) {
-  main().catch(error => {
-    if (error instanceof ValidationError) {
-      console.error('Invalid OpenAPI 3.1 specification:')
-      error.errors.forEach(err => console.error(err))
-    } else {
-      console.error('Error:', error.message)
-    }
-    process.exit(1)
-  })
+  return proxy.getServer()
 }
+
+startServer().catch(error => {
+  if (error instanceof ValidationError) {
+    console.error('Invalid OpenAPI 3.1 specification:')
+    error.errors.forEach(err => console.error(err))
+  } else {
+    console.error('Error:', error)
+  }
+  process.exit(1)
+})

package/src/init-server.ts

@@ -0,0 +1,50 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+import { OpenAPIV3 } from 'openapi-types'
+import OpenAPISchemaValidator from 'openapi-schema-validator'
+
+import { MCPProxy } from './openapi-mcp-server/mcp/proxy'
+
+export class ValidationError extends Error {
+  constructor(public errors: any[]) {
+    super('OpenAPI validation failed')
+    this.name = 'ValidationError'
+  }
+}
+
+async function loadOpenApiSpec(specPath: string, baseUrl: string | undefined): Promise<OpenAPIV3.Document> {
+  let rawSpec: string
+
+  try {
+    rawSpec = fs.readFileSync(path.resolve(process.cwd(), specPath), 'utf-8')
+  } catch (error) {
+    console.error('Failed to read OpenAPI specification file:', (error as Error).message)
+    process.exit(1)
+  }
+
+  // Parse and validate the OpenApi Spec
+  try {
+    const parsed = JSON.parse(rawSpec)
+
+    // Override baseUrl if specified.
+    if (baseUrl) {
+      parsed.servers[0].url = baseUrl
+    }
+
+    return parsed as OpenAPIV3.Document
+  } catch (error) {
+    if (error instanceof ValidationError) {
+      throw error
+    }
+    console.error('Failed to parse OpenAPI spec:', (error as Error).message)
+    process.exit(1)
+  }
+}
+
+export async function initProxy(specPath: string, baseUrl: string |undefined) {
+  const openApiSpec = await loadOpenApiSpec(specPath, baseUrl)
+  const proxy = new MCPProxy('Notion API', openApiSpec)
+
+  return proxy
+}

package/src/openapi-mcp-server/README.md

@@ -1 +1,3 @@
 Note: This is a fork from v1 of https://github.com/snaggle-ai/openapi-mcp-server. The library took a different direction with v2 which is not compatible with our development approach.
+
+Forked to upgrade vulnerable dependencies and easier setup.

package/src/openapi-mcp-server/client/http-client.ts

@@ -40,6 +40,7 @@ export class HttpClient {
         baseURL: config.baseUrl,
         headers: {
           'Content-Type': 'application/json',
+          'User-Agent': 'notion-mcp-server',
           ...config.headers,
         },
       },

package/src/openapi-mcp-server/mcp/proxy.ts

@@ -167,4 +167,8 @@ export class MCPProxy {
     // The SDK will handle stdio communication
     await this.server.connect(transport)
   }
+
+  getServer() {
+    return this.server
+  }
 }