Cosense MCP Server

Instructions

    Get a page from my-project project on cosen.se

    In cosense, a page is a cosense-style document with a title and a description.
    Bracket Notation makes links between pages.
    Example: [Page Title]
    -> "/my-project/Page Title"

    A page may have links to other pages.
    Links are rendered at the bottom of the page.
    

Implementation Reference

• src/index.ts:126-142 (handler)

  Handler for the 'get_page' tool in the CallToolRequestSchema. Extracts pageTitle from arguments, fetches the page using getPage helper, formats it, and returns text content.

  case "get_page": {
    const pageTitle = String(request.params.arguments?.pageTitle);
    const page = await getPage(projectName, pageTitle, cosenseSid);
    if (!page) {
      throw new Error(`Page ${pageTitle} not found`);
    }
    const readablePage = toReadablePage(page);
  
    return {
      content: [
        {
          type: "text",
          text: readablePage.description,
        },
      ],
    };
  }

• src/index.ts:100-109 (schema)

  Input schema definition for the 'get_page' tool, specifying pageTitle as required string.

  inputSchema: {
    type: "object",
    properties: {
      pageTitle: {
        type: "string",
        description: "Title of the page",
      },
    },
    required: ["pageTitle"],
  },

• src/index.ts:87-110 (registration)

  Registration of the 'get_page' tool in the ListToolsRequestSchema response, including name, description, and input schema.

  {
    name: "get_page",
    description: `
    Get a page from ${projectName} project on cosen.se
  
    In cosense, a page is a cosense-style document with a title and a description.
    Bracket Notation makes links between pages.
    Example: [Page Title]
    -> "/${projectName}/Page Title"
  
    A page may have links to other pages.
    Links are rendered at the bottom of the page.
    `,
    inputSchema: {
      type: "object",
      properties: {
        pageTitle: {
          type: "string",
          description: "Title of the page",
        },
      },
      required: ["pageTitle"],
    },
  },

• src/cosense.ts:19-37 (helper)

  Helper function that performs the actual API fetch to retrieve page data from cosen.se.

  async function getPage(
    projectName: string,
    pageName: string,
    sid?: string,
  ): Promise<GetPageResponse | null> {
    const response = sid
      ? await fetch(`https://cosen.se/api/pages/${projectName}/${pageName}`, {
          headers: { Cookie: `connect.sid=${sid}` },
        }).catch(() => null)
      : await fetch(
          `https://cosen.se/api/pages/${projectName}/${pageName}`,
        ).catch(() => null);
  
    if (!response) {
      return null;
    }
    const page = await response.json();
    return page as GetPageResponse;
  }

• src/cosense.ts:39-59 (helper)

  Helper function to transform raw GetPageResponse into a readable format with title and description including content and links.

  function toReadablePage(page: GetPageResponse): {
    title: string;
    description: string;
  } {
    const titleAndDescription = `
  ${page.title}
  ---
  
  ${page.lines.map((line) => line.text).join("\n")}
  `;
  
    const relatedPages =
      page.links.length > 0
        ? `## 関連するページのタイトル
  ${page.links.join("\n")}
  `
        : "";
    return {
      title: page.title,
      description: titleAndDescription + "\n" + relatedPages,
    };