Backlog MCP Server

Instructions

Implementation Reference

• src/tools/getWiki.ts:29-33 (handler)

  The handler function that executes the core logic of the 'get_wiki' tool by parsing the wikiId and calling backlog.getWiki(wikiIdNumber) to retrieve the wiki page information.

  handler: async ({ wikiId }) => {
    const wikiIdNumber =
      typeof wikiId === 'string' ? parseInt(wikiId, 10) : wikiId;
    return backlog.getWiki(wikiIdNumber);
  },

• src/tools/getWiki.ts:7-11 (schema)

  Input schema definition for the 'get_wiki' tool using Zod, specifying the wikiId parameter which can be a string or number.

  const getWikiSchema = buildToolSchema((t) => ({
    wikiId: z
      .union([z.string(), z.number()])
      .describe(t('TOOL_GET_WIKI_ID', 'Wiki ID')),
  }));

• src/tools/tools.ts:125-125 (registration)

  Registration of the 'get_wiki' tool by instantiating getWikiTool and adding it to the 'wiki' toolset in the allTools function.

  getWikiTool(backlog, helper),

• src/tools/getWiki.ts:13-35 (registration)

  The complete tool definition and export of the 'get_wiki' tool, including name, description, schema, output schema, and handler.

  export const getWikiTool = (
    backlog: Backlog,
    { t }: TranslationHelper
  ): ToolDefinition<
    ReturnType<typeof getWikiSchema>,
    (typeof WikiSchema)['shape']
  > => {
    return {
      name: 'get_wiki',
      description: t(
        'TOOL_GET_WIKI_DESCRIPTION',
        'Returns information about a specific wiki page'
      ),
      schema: z.object(getWikiSchema(t)),
      outputSchema: WikiSchema,
      importantFields: ['id', 'projectId', 'name', 'content'],
      handler: async ({ wikiId }) => {
        const wikiIdNumber =
          typeof wikiId === 'string' ? parseInt(wikiId, 10) : wikiId;
        return backlog.getWiki(wikiIdNumber);
      },
    };
  };