outline-mcp-server 5.0.0 → 5.1.0

package/README.md

@@ -2,11 +2,15 @@
 
 A Model Context Protocol (MCP) server that provides tools for interacting with [Outline](https://www.getoutline.com/)'s API, enabling AI agents to manage documents, collections, and other entities programmatically through the Outline knowledge base platform.
 
-> **Upgrade Notice:**
-
-- v5 has introduced several breaking changes:
-  - this server support for both `stdio` and `sse` transport interfaces. It now solely exposes a [Streamable HTTP endpoint](https://modelcontextprotocol.io/specification/draft/basic/transports#streamable-http) at the `/mcp` route. If you require sse/stdio, downgrade to v4
-  - the `--port` CLI flag has been migrated to an environment variable, `OUTLINE_MCP_PORT`
+## 🚨 \***\*Upgrade Notice:\*\*** v5 has introduced several breaking changes: 🚨
+
+- support has been dropped for the `stdio` transport interfaces.
+  - This server now exposes:
+    - a [Streamable-HTTP endpoint](https://modelcontextprotocol.io/specification/draft/basic/transports#streamable-http) at the `/mcp` route.
+    - an SSE endpoint at `/sse`
+  - If you require stdio, downgrade to v4
+- the `--port` CLI flag has been migrated to an environment variable, `OUTLINE_MCP_PORT`
+- Minimum node version has been bumped to 20
 
 ## Features
 

package/build/index.js

@@ -1,11 +1,13 @@
+#!/usr/bin/env bun
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
 import fastify from 'fastify';
 import { getMcpServer } from './utils/getMcpServer.js';
-const server = fastify();
+const app = fastify();
+const mcpServer = await getMcpServer();
 // Stateless mode (default, recommended for most deployments)
-server.post('/mcp', async (request, reply) => {
+app.post('/mcp', async (request, reply) => {
     try {
-        const mcpServer = await getMcpServer();
         const httpTransport = new StreamableHTTPServerTransport({
             sessionIdGenerator: undefined,
         });
@@ -29,7 +31,7 @@ server.post('/mcp', async (request, reply) => {
         }
     }
 });
-server.get('/mcp', async (request, reply) => {
+app.get('/mcp', async (request, reply) => {
     reply.code(405).send({
         jsonrpc: '2.0',
         error: {
@@ -39,7 +41,7 @@ server.get('/mcp', async (request, reply) => {
         id: null,
     });
 });
-server.delete('/mcp', async (request, reply) => {
+app.delete('/mcp', async (request, reply) => {
     reply.code(405).send({
         jsonrpc: '2.0',
         error: {
@@ -49,8 +51,40 @@ server.delete('/mcp', async (request, reply) => {
         id: null,
     });
 });
+// Legacy SSE endpoint for older clients
+let sseTransport = null;
+app.get('/sse', async (request, reply) => {
+    try {
+        // Create SSE transport for legacy clients
+        if (!sseTransport) {
+            sseTransport = new SSEServerTransport('/messages', reply.raw);
+            await mcpServer.connect(sseTransport);
+        }
+    }
+    catch (error) {
+        console.error(error);
+        if (!reply.sent) {
+            reply.code(500).send({
+                jsonrpc: '2.0',
+                error: {
+                    code: -32603,
+                    message: 'Internal server error',
+                },
+                id: null,
+            });
+        }
+    }
+});
+// Legacy message endpoint for older clients
+app.post('/messages', async (req, res) => {
+    if (!sseTransport) {
+        res.status(400).send('No transport found');
+        return;
+    }
+    await sseTransport.handlePostMessage(req.raw, res.raw, req.body);
+});
 const PORT = process.env.OUTLINE_MCP_PORT ? parseInt(process.env.OUTLINE_MCP_PORT, 10) : 6060;
-server.listen({ port: PORT }, (err, address) => {
+app.listen({ port: PORT }, (err, address) => {
     if (err) {
         console.error(err);
         process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "outline-mcp-server",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "description": "An MCP server for interacting with Outline's API",
   "type": "module",
   "bin": {
@@ -23,7 +23,7 @@
     "prepare": "npm run build",
     "watch": "bun --watch src/index.ts",
     "dev": "concurrently -n 'build,inspector' -c 'blue.bold,green.bold' 'npm run watch' 'npm run inspector'",
-    "inspector": "npx @modelcontextprotocol/inspector@latest -y",
+    "inspector": "npx @modelcontextprotocol/inspector@latest",
     "start": "bun build/index.js",
     "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json}\"",
     "semantic-release": "semantic-release"