get-juejin-article-rank

Retrieve ranked technical articles from Juejin platform across categories like frontend development, backend technology, AI, mobile development, and technical architecture to discover high-quality Chinese technical content.

Instructions

获取掘金文章榜，包含前端开发、后端技术、人工智能、移动开发及技术架构等领域的高质量中文技术文章和教程

Input Schema

TableJSON Schema

Name	Required	Description	Default
`category_id`	No

Implementation Reference

src/mcp.ts:15-36 (handler)

Core proxy function that executes the tool logic by making a POST request to the remote API endpoint 'https://mcp.xiaobenyang.com/api' with the tool name in the 'func' header and arguments in the body. This handles all dynamic tools including 'get-juejin-article-rank'.

const calcXiaoBenYangApi = async function (fullArgs: Record<string, any>) {
    // 发起 POST 请求
    let response = await fetch('https://mcp.xiaobenyang.com/api', {
        method: 'POST',
        headers: {
            'XBY-APIKEY': apiKey,
            'func': fullArgs.toolName,
            'mcpid': mcpID
        },
        body: new URLSearchParams(fullArgs)
    });
    const apiResult = await response.text();

    return {
        content: [
            {
                type: "text",
                text: apiResult // 将字符串结果放入 content 中
            }
        ]
    } as { [x: string]: unknown; content: [{ type: "text"; text: string }] };
};

src/mcp.ts:39-48 (handler)

Wrapper handler function called by the registered tool handler, adds toolName to args and invokes the core proxy function.

const handleXiaoBenYangApi = async (args: Record<string, any>, toolName: string) => {
    // 校验aid是否存在
    if (toolName === undefined || toolName === null) {
        throw new Error("缺少必要参数 'aid'");
    }
    // 合并参数
    const fullArgs = {...args, toolName: toolName};
    // 调用API
    return calcXiaoBenYangApi(fullArgs);
};

src/mcp.ts:50-65 (registration)

Helper function that registers each dynamic tool on the MCP server, specifying name, description, input schema, and the proxy handler lambda.

const addToolXiaoBenYangApi = function (
    name: string,
    desc: string,
    params: Record<string, ZodType>
) {
    server.registerTool(
        name,
        {
            title: name,
            description: desc,
            inputSchema: params,
        }
        ,
        async (args: Record<string, any>) => handleXiaoBenYangApi(args, name)
    )
};

src/mcp.ts:90-132 (registration)

Dynamic registration loop: fetches tool descriptions from remote API for mcpID '1777316659328003', builds Zod input schemas, and registers each tool (including 'get-juejin-article-rank' if present in the remote list) using addToolXiaoBenYangApi.

for (const apiDesc of apiDescList) {
    let inputSchema = JSON.parse(apiDesc.inputSchema);
    const zodDict: Record<string, z.ZodTypeAny> = {};

    Object.entries(inputSchema.properties).forEach(([name, propConfig]) => {
        let zodType;
        let pt = (propConfig as { type: string }).type;
        switch (pt) {
            case 'string':
                zodType = z.string();
                break;
            case 'number':
                zodType = z.number();
                break;
            case 'boolean':
                zodType = z.boolean();
                break;
            case 'integer':
                zodType = z.int32();
                break;
            case 'array':
                zodType = z.array(z.any());
                break;
            case 'object':
                zodType = z.object(z.any());
                break;
            default:
                zodType = z.any();
        }

        if (inputSchema.required?.includes(name)) {
            zodDict[name] = zodType;
        } else {
            zodDict[name] = zodType.optional();
        }
    });


    addToolXiaoBenYangApi(
        apiDesc.name,
        apiDesc.description ? apiDesc.description : apiDesc.name,
        zodDict);
}

src/mcp.ts:94-127 (schema)

Dynamic schema generation: converts JSON schema properties from remote tool descriptions into Zod types for input validation, handling required/optional fields.

Object.entries(inputSchema.properties).forEach(([name, propConfig]) => {
    let zodType;
    let pt = (propConfig as { type: string }).type;
    switch (pt) {
        case 'string':
            zodType = z.string();
            break;
        case 'number':
            zodType = z.number();
            break;
        case 'boolean':
            zodType = z.boolean();
            break;
        case 'integer':
            zodType = z.int32();
            break;
        case 'array':
            zodType = z.array(z.any());
            break;
        case 'object':
            zodType = z.object(z.any());
            break;
        default:
            zodType = z.any();
    }

    if (inputSchema.required?.includes(name)) {
        zodDict[name] = zodType;
    } else {
        zodDict[name] = zodType.optional();
    }
});

Hot-News