mirror of
https://github.com/outline/outline.git
synced 2026-11-22 14:01:41 +03:00
* Ensure full urls are returned from MCP towards #11474 * Fix pathToUrl using path.join for URLs and add test coverage path.join collapsed https:// to https:/ — use URL constructor instead. Added assertions verifying full URLs are returned for collections and documents across list, create, update, and resource endpoints. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * Add scopes_supported --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
98 lines
2.7 KiB
TypeScript
98 lines
2.7 KiB
TypeScript
import type { AuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
|
|
import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
import type { Team, User } from "@server/models";
|
|
import { type APIContext, AuthenticationType } from "@server/types";
|
|
|
|
interface McpContext {
|
|
authInfo?: AuthInfo;
|
|
}
|
|
|
|
/**
|
|
* Extracts the authenticated user from the MCP request handler extra object.
|
|
*
|
|
* @param context - the extra object passed to MCP tool handlers.
|
|
* @returns the authenticated user.
|
|
*/
|
|
export function getActorFromContext(context: McpContext) {
|
|
return context.authInfo?.extra?.user as User;
|
|
}
|
|
|
|
/**
|
|
* Constructs a minimal APIContext from the MCP request context for use with
|
|
* server commands that require a Koa-style context.
|
|
*
|
|
* @param context - the MCP request context.
|
|
* @returns a partial APIContext suitable for command functions.
|
|
*/
|
|
export function buildAPIContext(context: McpContext) {
|
|
const user = context.authInfo?.extra?.user as User;
|
|
const token = context.authInfo?.token ?? "";
|
|
|
|
const auth = {
|
|
user,
|
|
token,
|
|
type: AuthenticationType.OAUTH,
|
|
};
|
|
|
|
return {
|
|
state: { auth },
|
|
context: { auth },
|
|
} as unknown as APIContext;
|
|
}
|
|
|
|
/**
|
|
* Helper function to format successful MCP tool responses.
|
|
*
|
|
* @param data - the data to include in the response.
|
|
* @returns a formatted response object for MCP tools.
|
|
*/
|
|
export function success<T>(data: T | T[]): CallToolResult {
|
|
const payload = Array.isArray(data) ? data : [data];
|
|
|
|
return {
|
|
content: payload.map((item) => ({
|
|
type: "text" as const,
|
|
text: JSON.stringify(item),
|
|
})),
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Helper function to format error MCP tool responses.
|
|
*
|
|
* @param message - the error message or error to include in the response.
|
|
* @returns a formatted error response object for MCP tools.
|
|
*/
|
|
export function error(err: unknown): CallToolResult {
|
|
const message = err instanceof Error ? err.message : String(err);
|
|
|
|
return {
|
|
content: [{ type: "text" as const, text: message }],
|
|
isError: true,
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Utility function to construct a URL by joining a team URL with a path segment.
|
|
*
|
|
* @param team - the team object containing the base URL.
|
|
* @param input - an object with attributes keys to be joined with the team URL.
|
|
* @returns the combined URL string.
|
|
*/
|
|
export function pathToUrl(team: Team, input: Record<string, unknown>) {
|
|
const baseUrl = team.url;
|
|
|
|
for (const [key, value] of Object.entries(input)) {
|
|
if (["url", "path"].includes(key) && typeof value === "string") {
|
|
// check for existing protocol to avoid double joining
|
|
if (/^https?:\/\//.test(value)) {
|
|
input[key] = value;
|
|
} else {
|
|
input[key] = new URL(value, baseUrl).href;
|
|
}
|
|
}
|
|
}
|
|
|
|
return input;
|
|
}
|