NocoDB MCP Server

Instructions

Implementation Reference

• src/tools/database.ts:46-57 (handler)

  The handler function that fetches detailed information about a specific NocoDB base using the provided base_id and returns structured base details.

  handler: async (client: NocoDBClient, args: { base_id: string }) => {
    const base = await client.getBase(args.base_id);
    return {
      base: {
        id: base.id,
        title: base.title,
        status: base.status,
        created_at: base.created_at,
        updated_at: base.updated_at,
      },
    };
  },

• src/tools/database.ts:36-45 (schema)

  Input schema defining the required base_id parameter as a string.

  inputSchema: {
    type: "object",
    properties: {
      base_id: {
        type: "string",
        description: "The ID of the base/project",
      },
    },
    required: ["base_id"],
  },

• src/tools/database.ts:33-58 (registration)

  Tool definition registered in the databaseTools array.

  {
    name: "get_base_info",
    description: "Get detailed information about a specific base/project",
    inputSchema: {
      type: "object",
      properties: {
        base_id: {
          type: "string",
          description: "The ID of the base/project",
        },
      },
      required: ["base_id"],
    },
    handler: async (client: NocoDBClient, args: { base_id: string }) => {
      const base = await client.getBase(args.base_id);
      return {
        base: {
          id: base.id,
          title: base.title,
          status: base.status,
          created_at: base.created_at,
          updated_at: base.updated_at,
        },
      };
    },
  },

• src/index.ts:55-62 (registration)

  Combines all tool sets including databaseTools into allTools, which is used for MCP tool listing and execution.

  const allTools = [
    ...databaseTools,
    ...tableTools,
    ...recordTools,
    ...viewTools,
    ...queryTools,
    ...attachmentTools,
  ];