RAP2 MCP Server

Instructions

Implementation Reference

• src/mcp-server.js:180-196 (handler)

  Executes the rap2_test_connection tool: creates Rap2Client, probes /repository/joined endpoint, auto-logins if needed, returns {ok, status, didLogin} as JSON text.

  if (name === 'rap2_test_connection') {
    const client = createClient();
    const probe = async () => client._fetch('/repository/joined');
    let res = await probe();
    const looksLikeHtml = !!res?.data?.raw;
    const notOk = res?.status !== 200 || looksLikeHtml || res?.data?.isOk === false;
    let didLogin = false;
    if (notOk) {
      const login = await client.login();
      didLogin = !login?.error;
      res = await probe();
    }
    const ok = res?.status === 200 && !res?.data?.raw;
    const payload = { ok, status: res?.status ?? 0, didLogin };
    logger.info({ tool: name, result: payload }, 'tool success');
    return { content: [{ type: 'text', text: JSON.stringify(payload) }] };
  }

• src/mcp-server.js:95-101 (schema)

  Tool metadata including name, description, and empty inputSchema (no parameters). Used for tool listing and validation.

    name: 'rap2_test_connection',
    description: '测试连接并校验会话：探测 /repository/joined，必要时自动登录后再探测（可用提示：\"测试rap连接\"、\"确保已登录\"）',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  },

• src/mcp-server.js:166-169 (registration)

  Registers the tools list (including rap2_test_connection) in the MCP server's capabilities for tool discovery.

  const server = new Server(
    { name: 'rap2-mcp-tool', version: '0.1.9' },
    { capabilities: { tools: { list: tools } } },
  );