@notionhq/notion-mcp-server 1.0.0 → 1.2.0

package/package.json

@@ -2,10 +2,11 @@
   "name": "@notionhq/notion-mcp-server",
   "keywords": [
     "notion",
+    "api",
     "mcp",
     "server"
   ],
-  "version": "1.0.0",
+  "version": "1.2.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/notion-openapi.json

@@ -31,28 +31,7 @@
         "description": "The [API version](https://developers.notion.com/reference/versioning) to use for this request. The latest version is `2022-06-28`."
       }
     },
-    "schemas": {
-      "pageIdObject": {
-        "type": "object",
-        "properties": {
-          "page_id": {
-            "type": "string"
-          }
-        },
-        "additionalProperties": false,
-        "required": ["page_id"]
-      },
-      "databaseIdObject": {
-        "type": "object",
-        "properties": {
-          "database_id": {
-            "type": "string"
-          }
-        },
-        "additionalProperties": false,
-        "required": ["database_id"]
-      }
-    }
+    "schemas": {}
   },
   "security": [
     {
@@ -647,7 +626,14 @@
                 ],
                 "properties": {
                   "parent": {
-                    "$ref": "#/components/schemas/pageIdObject"
+                    "type": "object",
+                    "properties": {
+                      "page_id": {
+                        "type": "string",
+                        "format": "uuid"
+                      }
+                    },
+                    "required": ["page_id"]
                   },
                   "properties": {
                     "type": "object",
@@ -717,24 +703,79 @@
             "application/json": {
               "schema": {
                 "type": "object",
-                "required": [
-                  "parent",
-                  "properties"
-                ],
+                "required": ["parent","properties"],
                 "properties": {
                   "parent": {
-                    "type": "string",
-                    "description": "A [page parent](/reference/database#page-parent)",
-                    "format": "json"
-                  },
-                  "title": {
-                    "type": "array",
-                    "description": "Title of database as it appears in Notion. An array of [rich text objects](ref:rich-text)."
+                    "type": "object",
+                    "properties": {
+                      "type": {
+                        "enum": ["page_id"]
+                      },
+                      "page_id": {
+                        "type": "string",
+                        "format": "uuid"
+                      }
+                    },
+                    "required": ["type", "page_id"]
                   },
                   "properties": {
-                    "type": "string",
+                    "type": "object",
                     "description": "Property schema of database. The keys are the names of properties as they appear in Notion and the values are [property schema objects](https://developers.notion.com/reference/property-schema-object).",
-                    "format": "json"
+                    "additionalProperties": {
+                      "oneOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "title": {
+                              "type": "object",
+                              "properties": {},
+                              "additionalProperties": false
+                            },
+                            "description": {
+                              "type": "string",
+                              "maxLength": 280,
+                              "minLength": 1
+                            }
+                          },
+                          "additionalProperties": false,
+                          "required": ["title"]
+                        }
+                      ]
+                    }
+                  },
+                  "title": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "required": ["text"],
+                      "properties": {
+                        "text": {
+                          "type": "object",
+                          "properties": {
+                            "content": {
+                              "type": "string",
+                              "maxLength": 2000
+                            },
+                            "link": {
+                              "type": ["object", "null"],
+                              "properties": {
+                                "url": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": ["url"]
+                            }
+                          },
+                          "additionalProperties": false,
+                          "required": ["content"]
+                        },
+                        "type": {
+                          "enum": ["text"]
+                        }
+                      },
+                      "additionalProperties": false
+                    },
+                    "maxItems": 100
                   }
                 }
               }

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
+  }
 }

package/tsconfig.json

@@ -22,5 +22,5 @@
     "strict": true,
     "skipLibCheck": true
   },
-  "include": [ "test/**/*.ts", "scripts/**/*.ts", "src/**/*.ts", "examples/**/*"]
+  "include": [ "test/**/*.ts", "scripts/**/*.ts", "src/**/*.ts"]
 }