Tiptap Collaboration MCP Server

Instructions

Implementation Reference

• src/tools/get-server-statistics.ts:12-56 (handler)

  Handler function that fetches server statistics via API call to /api/statistics, formats the response as text content, and handles errors gracefully.

  async () => {
    try {
      const headers: Record<string, string> = {
        'User-Agent': 'tiptap-collaboration-mcp',
        'Content-Type': 'application/json',
      };
  
      const token = getToken();
      if (token) headers['Authorization'] = token;
  
      const response = await fetch(`${getBaseUrl()}/api/statistics`, { headers });
  
      if (!response.ok) {
        return {
          content: [
            {
              type: 'text',
              text: `Failed to retrieve server statistics. HTTP error: ${response.status} ${response.statusText}`,
            },
          ],
        };
      }
  
      const statistics = await response.json();
  
      return {
        content: [
          {
            type: 'text',
            text: `Server Statistics: ${JSON.stringify(statistics, null, 2)}`,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Error retrieving server statistics: ${
              error instanceof Error ? error.message : 'Unknown error'
            }`,
          },
        ],
      };
    }

• src/tools/get-server-statistics.ts:8-58 (registration)

  Registers the "get-server-statistics" tool on the MCP server using server.tool(), with tool name, description, empty schema, and handler function.

  server.tool(
    'get-server-statistics',
    'Get server-wide statistics including total documents, connections, and usage metrics',
    {},
    async () => {
      try {
        const headers: Record<string, string> = {
          'User-Agent': 'tiptap-collaboration-mcp',
          'Content-Type': 'application/json',
        };
  
        const token = getToken();
        if (token) headers['Authorization'] = token;
  
        const response = await fetch(`${getBaseUrl()}/api/statistics`, { headers });
  
        if (!response.ok) {
          return {
            content: [
              {
                type: 'text',
                text: `Failed to retrieve server statistics. HTTP error: ${response.status} ${response.statusText}`,
              },
            ],
          };
        }
  
        const statistics = await response.json();
  
        return {
          content: [
            {
              type: 'text',
              text: `Server Statistics: ${JSON.stringify(statistics, null, 2)}`,
            },
          ],
        };
      } catch (error) {
        return {
          content: [
            {
              type: 'text',
              text: `Error retrieving server statistics: ${
                error instanceof Error ? error.message : 'Unknown error'
              }`,
            },
          ],
        };
      }
    }
  );

• src/tools/get-server-statistics.ts:11-11 (schema)

  Empty input schema indicating the tool takes no parameters.

  {},

• src/server.ts:55-55 (registration)

  Calls the registration function for get_server_statistics tool during main server setup.

  registerGetServerStatistics(server, getBaseUrl, getToken);